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:
- Agents run on: Claude or Codex, for every agent in the template.
- name: the project's name. Leave it empty to use the template's.
- Describe it: your own Claude Code or Codex drafts a team from a description. See designing teams.
- Templates: Solo agent, Builder → Reviewer, Planner → 2 Builders, Blank canvas, Textbook creator, Adaptive support team, Independent reviewers, and Design and revise. See examples.
- Advanced: import a team file (
.sculptured-team.json, or an OpenRig YAML file), or import a past run (.sculptured-session.jsonl), which opens read-only in Results › History. See team files.
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 details | What it sets |
|---|---|
| Name | What the team and you call it. Two agents can't share a name. |
| Job | Its first message when the team starts. See writing a Job. |
| Folder | Its own folder, or Use project folder. |
| Runs on and model | Claude or Codex, and which model. |
| Hands work to | Who receives its finished work (Connect to…). |
| Group | Which group it sits in. |
| Token limit, Check | A token cap and an after-turn command. |
| Advanced | When it restarts and Permissions. |
The other buttons on the bar:
- Group adds an empty group box. Saved groups opens your Library to drag a saved group in.
- The folder button sets the folder for every agent.
- Full text shows every card's full Job instead of a preview.
- Undo (Ctrl+Z) and Redo (Ctrl+Shift+Z).
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.
| Arrow | Drawn | What happens when the team runs |
|---|---|---|
| hands work to | solid | The 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 to | dashed | Nothing automatic. It describes intent, shown on the board and to the agents. |
| watches | dashed | Nothing 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.
- Give it to more agents: drag from the Input's ● to an agent, or tick the agent under Goes to in its editor.
- Edit or remove it: click it, or right-click it. Remove the Input (or Delete on it) takes it off the board.
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.
- Put an agent in: drag its card into the box, or choose its group under Group in its details.
- Take it out: drag the card onto empty board, or right-click it and choose Take out of its group.
- Remove the box but keep the agents: right-click the group and choose Ungroup. Delete group and its agents removes both.
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:
| Do | Keyboard (Command on a Mac) | Menu |
|---|---|---|
| Copy | Ctrl+C | Right-click → Copy |
| Paste | Ctrl+V | Right-click the board → Paste here |
| Duplicate | Ctrl+D | Right-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
| Do | Mouse | Keyboard |
|---|---|---|
| Add an agent | Drag + Claude onto the board | n then Enter |
| Move a card or group | Drag it | Select it, then the arrow keys (Shift for bigger steps) |
| Select an agent, group or arrow | Click it | Tab |
| Open an agent's details | Click it | Enter on it |
| Delete the selection | Right-click → Delete | Delete or Backspace |
| Copy, paste, duplicate | Right-click | Ctrl+C, Ctrl+V, Ctrl+D |
| Leave the selection | Click empty board | Esc |
| Zoom | The − + buttons | - and + |
| Fit everything | Fit | f |
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:
| Message | Fix |
|---|---|
| Add at least one agent to start the team | Add an agent. |
| Name needs a folder to work in | Set 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\project | Use a full path, not ~/project or a relative one. |
| Two agents are called Name; give each its own name | Rename one. |
| A → B is part of a loop (…) that no other agent hands work into, so the work has no starting point | Connect an agent outside the loop to one in it, or remove one arrow. |
| A group needs a name | Name 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.