Sculptured docs

Compose on the board

Choose a folder, add agents and connect handoffs on the Design board.

Use the Design board to build a team: choose its working folder, add agents, write their jobs and connect their handoffs. The Run tab opens after the team starts and shows its activity.

Start a project

Press New project on the Projects page or in the Projects menu of the top bar, or press n anywhere except the Design board (there, n adds an agent). The New project page offers:

Rename the project

Double-click the project name next to the Design and Run tabs, or focus it and press Enter or F2. Type the new name and press Enter. Esc puts the old name back. You can also edit Team name in the team details.

Choose folders

Every agent needs a folder to work in. Set one folder for the whole project and every agent inherits it, unless you give an agent its own.

Hosted (connected computer)

In the team details, Folder on your computer takes a full path on the computer that runs the team, for example /home/you/project or C:\Users\you\project. Browse… lists the folders that computer allows. The folder must be inside one of them (sculptured allow <folder> adds more). Leave it empty to use the computer's first allowed folder.

Run on picks the computer. Automatic uses your only connected computer. With none connected, follow Connect one. See connect a computer.

Local

In the team details, Project folder → Choose project folder… opens a folder picker. Clear project folder removes it. If some agents use their own folders, Use project folder for all agents resets them.

Add agents

The Design toolbar above the board has Add agent, which adds the kind most of the team runs on (Claude in a new team). More tools next to it shows the other kind, Codex. Drag either onto the board, or click it to add the agent in the next free spot. You can also right-click the board and choose Add a Claude agent here. A new agent opens its details so you can name it and write its Job.

Cards go exactly where you drop them. A card dragged close to another lines up with it: the same row or column, or the usual spacing beside it.

Each card shows the agent's name, what it runs on, its model, and its Job. A card with no Job says "No job yet. Select the agent to write one."

In the agent's detailsWhat it sets
NameWhat the team and you call it. Two agents can't share a name.
JobIts first message when the team starts. See writing a Job.
FolderIts own folder, or Use project folder.
Runs on and modelClaude or Codex, and which model.
Hands work toWho receives its finished work (Connect to…).
GroupWhich group it sits in.
Token limit, CheckA token cap and an after-turn command.
AdvancedWhen it restarts and Permissions.

The other buttons on the bar:

Connect work

Drag from an agent's ● handle to another agent, or use Connect to… under Hands work to in its details. Click an arrow to open it: you can change its Source agent, Destination agent and Kind, or drag either end of a selected arrow to another agent.

ArrowDrawnWhat happens when the team runs
hands work tosolidThe receiver starts after the giver. When the giver finishes a turn of work, its last reply is delivered to the receiver as a message.
reports todashedNothing automatic. It describes intent, shown on the board and to the agents.
watchesdashedNothing automatic. It describes intent.
flowchart LR
  P["Planner"] -- "hands work to" --> B1["Builder 1"]
  P -- "hands work to" --> B2["Builder 2"]
  B1 -- "hands work to" --> R["Reviewer"]
  B2 -- "hands work to" --> R

An agent with two incoming arrows, like Reviewer above, waits until both givers have a result; its first message then carries its Job and both results.

Arrows can form a loop, such as Builder → Reviewer → Builder, if an agent outside the loop provides the initial handoff. Agents do not wait for the returning arrow before starting; work returning along it arrives as More work.

Each piece of work can go around an ordinary loop at most three times. At that point the loop stops and shows a notice. Hand over again starts another pass. Use a workflow for named review outcomes and configurable round limits.

The Input

The Input holds what the project is about: the goal, links and notes. Open More tools in the Design toolbar and drag Input onto the board, click it, or right-click the board and choose Add the Input here. It starts out pointing to the agents where the work starts (those nobody hands work to), and its editor opens so you can write it.

When the team starts, each agent the Input goes to gets it after its own Job. An agent with no Job gets the Input as its first message. A project has one Input. Workflow projects keep their own Input, which the dispatcher reads.

Groups

A group organizes agents that share a purpose. Open More tools in the Design toolbar and choose Group, or right-click empty board and choose New group here, to add an empty group. You can also select several agents and choose Group in the bar that appears over the board. Add agents to it using the steps below.

The group's name means something to the agents. Every agent in the group is told the group's name and its other members, and an agent with an arrow to or from the group is told it is connected to that group. Name a group for what its agents do together, such as Quality checks.

While the team runs, agents can't change group.

Copy, paste and right-click

Select an agent or a group, then:

DoKeyboard (Command on a Mac)Menu
CopyCtrl+CRight-click → Copy
PasteCtrl+VRight-click the board → Paste here
DuplicateCtrl+DRight-click → Duplicate

A pasted agent keeps its Job, what it runs on, its folder and its settings, gets the next free name (Builder 2) and has no arrows. A pasted group brings its agents and the arrows between them. With a group selected, Ctrl+V pastes a copied agent into it. You can paste into another project open in the same browser.

Right-click also works on the board (add an agent or group there, paste, fit), on a group (rename, copy, add an agent, ungroup) and on an agent (open, copy, duplicate, what it runs on, delete).

Move around

DoMouseKeyboard
Add an agentDrag + Claude onto the boardn then Enter
Move a card or groupDrag itSelect it, then the arrow keys (Shift for bigger steps)
Select an agent, group or arrowClick itTab
Open an agent's detailsClick itEnter on it
Delete the selectionRight-click → DeleteDelete or Backspace
Copy, paste, duplicateRight-clickCtrl+C, Ctrl+V, Ctrl+D
Leave the selectionClick empty boardEsc
ZoomThe − + buttons- and +
Fit everythingFitf

Press ? for the full keymap. On a narrow screen the board becomes a form with one section per agent and the same edits.

Needs setup and Things to fix

Next to Start team, a status button reads Ready, Needs setup or Running. Open it to see why. While anything is wrong, Things to fix lists each problem; click one to select the agent, group or arrow it belongs to.

Common setup problems and their fixes:

MessageFix
Add at least one agent to start the teamAdd an agent.
Name needs a folder to work inSet a project folder, or one for that agent.
Name's folder must be a full path, such as /home/you/project or C:\Users\you\projectUse a full path, not ~/project or a relative one.
Two agents are called Name; give each its own nameRename one.
A → B is part of a loop (…) that no other agent hands work into, so the work has no starting pointConnect an agent outside the loop to one in it, or remove one arrow.
A group needs a nameName the group.

When nothing is left, the status reads "Ready to start. Each agent gets its job as its first message."

Start the team

Start team saves the design and asks you to confirm what starts, for example "Start 2 Claude agents?", with the folders they run in and which accounts they use. Agents with no incoming arrow start first.

While the team runs, you can rename agents, edit their Jobs and move cards. To add, remove or reconnect agents, stop the team first. See running a team.

Next steps