Create a workspace and agents
Create at least one agent before you create a workspace. A workspace needs one member and one leader, so the agents come first.
Before you start
- Ensemble
0.1.1is open in OpenCode. See Getting started. - OpenCode reports at least one model. The agent wizard cannot finish without a main model.
- You know the project directory the workspace will use.
- Read Agents, workspaces, and the leader if the roster, membership, or leader role is new to you.
Steps
Select an agent or the Agents section in the rail, then press
a. The new-agent wizard opens on Agent name.Type a unique name and press
Enter. Names are case-insensitive and must differ from every active agent.Type a short title and press
Enter, then type a role and pressEnter. The title is the label beside the agent; the role describes how it works and what it owns. The role is required.On Agent memories, press
a, type one memory, and pressEnter. Repeat for each entry, then pressEnteron the list to continue. This step is optional. An empty list skips it cleanly.Choose the main model with
j/kandEnter. If the model has variants, choose a reasoning effort on the next step. The model list comes from OpenCode. If it is empty, fix the host's provider configuration and reopen the wizard.Submit the final step. The new agent appears under Homeless and its direct chat opens. The agent now exists even though it has no workspace yet.
Press
nin the rail to create a workspace. The workspace wizard opens on Workspace directory.Choose the project directory, or choose Type a path… and type it. One canonical directory belongs to one active workspace.
Type a workspace name and press
Enter.On Workspace members, use
Spaceto toggle every agent that should join, then pressEnter. At least one member is required.On Workspace leader, choose one selected member and press
Enter. The leader receives every group message that names no agent.On Leader synthesis, choose whether child replies should combine into one final leader answer. Submit the step.
Expected result
- The workspace opens on its group chat, and the rail lists it under Workspaces.
- Each selected agent now appears under the workspace as its primary workspace.
- Ensemble writes
.ensemble/config.json. Run init when you want the generated team contract and roster block inAGENTS.md. - If a member had a home direct chat with no workspace, Ensemble asks whether to move that chat into the new workspace. Either choice keeps the agent usable.
Troubleshooting
- "Choose at least one member." Create an agent first, then rerun the workspace wizard.
- "A workspace already exists for this directory: <name>." Open the existing workspace instead of creating a second one for the same directory.
- "No models are available." Check the OpenCode provider and model list, then reload the host.
Next
- Edit members and the leader: change the team after creation.
- Route messages: send the first group or direct message.
- Configure an agent: add backups, skills, and settings.
- Configuration reference: exact workspace and settings fields.