Sculptured docs

FAQ

Short answers about what Sculptured is, what it costs to run, where it runs and what happens to your data.

About Sculptured

What is Sculptured?

A visual workspace for teams of coding agents. You design a team on a board: which agents, what each one's job is, and who hands work to whom. Then you run it and watch each agent's work, questions and evidence as it happens. See Introduction.

Which agents does it run?

Claude Code and Codex, the command-line agents from Anthropic and OpenAI.

Do I need to be a developer?

No. You design teams on the board and talk to agents in plain words. You do need Claude Code or Codex installed and signed in on the computer that runs your agents; the Computers page shows whether they are, with a Sign in button.

Is it open source?

Yes. The core, which includes the app, the agent runner and these docs, is Apache-2.0. You can run it yourself on one computer with no account.

What's the difference between the hosted beta and running it myself?

Running it yourself, everything is on one computer: the app, its data and the agents. With a Sculptured account, the app runs for you online, so you can open it from any browser, and your agents run on whichever computers you connect. The hosted beta is invite-only.

Cost and limits

What does running a team cost?

Your agents use your own Claude or ChatGPT plan, or API key, through Claude Code and Codex. Sculptured shows each turn's tokens and an estimated cost at API prices, with its source. If you use a subscription plan, that estimate is not your bill or a measure of your remaining allowance. Teams use many more tokens than a single agent, so start with one agent and split work only when it helps. See Designing teams.

Can a team run away and use my whole plan?

You can cap it. Give an agent a Token limit to soft-stop it, or a team an output budget to hard-stop it. Helpers agents start have no limit unless you set one on the team (Most agents, children included, Most levels of children). Sculptured also holds new work when your plan is at 90% of a usage window. See Limits.

Why do the token numbers change after a turn ends?

Claude Code and Codex report tokens when a turn ends, so counts can arrive up to one turn late. Sculptured shows them as the CLI reported them.

Computers

Which systems can I connect?

The agent runner runs on Linux (x86_64 and arm64), Windows (natively, no WSL) and macOS (Apple silicon and Intel). The Computers page offers only the systems that have a published build. If it says there is no build for your system yet, connect another computer for now.

Does the server run my agents?

No. Agents always run on a computer you connect, in folders that computer allows. The server sends instructions; your computer decides whether to accept them. See Security.

Does my terminal need to stay open?

No. The connect command installs the runner as a background service that starts again whenever you log in. You can close the terminal.

What happens if my laptop sleeps or the Wi-Fi drops?

A network interruption does not stop agents on a computer that is still awake. Their calls to Sculptured wait for the connection to return. Sleep pauses the computer and its agents. You can still answer open questions in the app; answers and stop requests reach the runner when it reconnects. See When a computer drops off.

Can agents read my whole computer?

Agents start only in folders the computer allows; the installer allows your home folder. Once running, what they can do depends on the computer's access level: Full (the default) lets them act as you do, and Sandboxed restricts Claude Code to asking first and Codex to writing inside its folder. Choose with sculptured connect … --sandboxed. See Security.

How do I disconnect a computer?

Press Disconnect on the Computers page. Its live link is dropped and its key stops working at once, so the runner can't connect again. To remove the background service from that computer as well:

Linux

systemctl --user disable --now sculptured-runner

macOS

launchctl unload -w ~/Library/LaunchAgents/dev.sculptured.runner.plist

Windows

Unregister-ScheduledTask -TaskName 'Sculptured runner' -Confirm:$false
Can I use more than one computer?

Yes. Connect each one. When more than one is connected, choose where a team runs under Runs on on the Design board.

Your data

What does Sculptured record about me?

The hosted beta collects usage analytics such as feature use, team counts, run statistics, token totals and errors. Those analytics exclude prompts, jobs, messages, agent output, file names and file contents. Separately, Sculptured stores team designs and run history so the app can work. Self-hosting keeps that data locally and collects no usage analytics. See Privacy.

Does my code leave my computer?

Your repositories remain on your computer. In hosted mode, agent replies, tool calls and results reach the server so you can follow the run; these may contain code. The server also receives folder listings, Git status or diffs you request. Claude Code and Codex send context to their providers as they do when used directly.

Can I take my teams with me?

Yes. Export team file saves a team as a .madl.yaml file (MADL) that you can import into any Sculptured, and that other tools can read. You can also download a run's history. See Team files.

Working with agents

An agent said it's done. Is the work correct?

Not necessarily. "Done" is the agent's own report. Sculptured labels it reported and keeps it apart from verified results, which come from a check Sculptured ran itself, such as your tests. End a team with a step that runs your checks. See States and evidence.

Can I change a team while it runs?

You can send agents guidance, rename them, edit jobs and move things. Changing agents' settings, arrows, groups or folders needs the team to be stopped first.

Do agents commit or push my code?

Sculptured doesn't commit or push for them. An agent can run Git itself if its job and access allow it. The Git panel lets you review and commit changes yourself. See Git workflows.

Where can I find ready-made teams?

In Community: examples such as a gstack-style product team and the Coding hospital, plus the CS2680 pattern catalog. See Examples and the pattern catalog.