Command reference
The command line has two separate catalogs. A : command runs a named navigation or state action. A / composer command runs a palette action, including destructive and selection actions that : deliberately does not expose.
Both parsers leave an unknown name visible: : reports Unknown command: <text> and / keeps the draft and flashes the composer border for one second.
: command line
The catalog contains 17 commands. A command without an argument column ignores extra words.
| Command | Arguments | Behavior |
|---|---|---|
:settings | none | Open agent Settings for the active or selected agent. |
:limits | none | Open the dispatch-limits panel. It edits group hops, command hops, depth, and continuations. Saved values apply to new commands only; running groups keep their captured caps. |
:approvals | none | Open the full-height approval inbox. |
:workspace | none | Open the workspace picker and switch the active workspace. |
:agent | none | Open the agent picker and start a direct chat. |
:new-agent | none | Open the new-agent wizard. |
:new-workspace | none | Open the new-workspace wizard. |
:edit-workspace | none | Edit the active workspace's members and leader. |
:pause | none | Pause the active workspace. A paused workspace rejects new work. |
:resume | none | Resume the active workspace. |
:init | none | Start a System Agent init job for the active workspace. Init is solo-only: :init takes no mentions, skills, or extra text. It writes the generated AGENTS.md block and .ensemble/init.json. /init and Space i reach the same path; :ensemble-init is not a valid command. |
:native | none | Open the active agent's native session. |
:native-first | on|off|shadow | Set the native-first migration mode through the validated settings path. off and shadow keep the legacy tool surface. on does not clear an explicit toolSurface: legacy; use :tools native to restore the native tools. |
:tools | native|legacy | Set the tool surface through the validated settings path. :tools native restores the native list after a legacy override. nativeFirst: off or shadow still forces the legacy list. |
:logs | [failures | task <id>] | Open the read-only log viewer. No argument shows recent entries; failures filters the failure sink; task <id> filters one work item. Invalid arguments show usage: :logs [failures | task <id>] |
:help | none | Open the generated keyboard help overlay. ? opens the same help. |
:q | none | Leave Ensemble deliberately and return the keys to the native OpenCode host. It does not quit OpenCode; Esc never quits. |
:settings
Open agent Settings for the active or selected agent.
Catalog description: open agent settings
Arguments: none (extra words are ignored)
Example: :settings
:limits
Open the dispatch-limits panel. It edits group hops, command hops, depth, and continuations. Saved values apply to new commands only; running groups keep their captured caps.
Catalog description: edit dispatch hop limits
Arguments: none (extra words are ignored)
Example: :limits
:approvals
Open the full-height approval inbox.
Catalog description: open the approval inbox
Arguments: none (extra words are ignored)
Example: :approvals
:workspace
Open the workspace picker and switch the active workspace.
Catalog description: switch workspace
Arguments: none (extra words are ignored)
Example: :workspace
:agent
Open the agent picker and start a direct chat.
Catalog description: open a direct conversation
Arguments: none (extra words are ignored)
Example: :agent
:new-agent
Open the new-agent wizard.
Catalog description: create an agent
Arguments: none (extra words are ignored)
Example: :new-agent
:new-workspace
Open the new-workspace wizard.
Catalog description: create a workspace
Arguments: none (extra words are ignored)
Example: :new-workspace
:edit-workspace
Edit the active workspace's members and leader.
Catalog description: edit members and leader
Arguments: none (extra words are ignored)
Example: :edit-workspace
:pause
Pause the active workspace. A paused workspace rejects new work.
Catalog description: pause the active workspace
Arguments: none (extra words are ignored)
Example: :pause
:resume
Resume the active workspace.
Catalog description: resume the active workspace
Arguments: none (extra words are ignored)
Example: :resume
:init
Start a System Agent init job for the active workspace. Init is solo-only: :init takes no mentions, skills, or extra text. It writes the generated AGENTS.md block and .ensemble/init.json. /init and Space i reach the same path; :ensemble-init is not a valid command.
Catalog description: initialize workspace files
Arguments: none (extra words are ignored)
Example: :init
:native
Open the active agent's native session.
Catalog description: open the native session
Arguments: none (extra words are ignored)
Example: :native
:native-first
Set the native-first migration mode through the validated settings path. off and shadow keep the legacy tool surface. on does not clear an explicit toolSurface: legacy; use :tools native to restore the native tools.
Catalog description: set native-first on, off, or shadow
Arguments: on|off|shadow
Example: :native-first on
:tools
Set the tool surface through the validated settings path. :tools native restores the native list after a legacy override. nativeFirst: off or shadow still forces the legacy list.
Catalog description: set the tool surface native or legacy
Arguments: native|legacy
Example: :tools native
:logs
Open the read-only log viewer. No argument shows recent entries; failures filters the failure sink; task <id> filters one work item. Invalid arguments show usage: :logs [failures | task <id>]
Catalog description: show recent logs (failures | task <id>)
Arguments: [failures | task <id>]
Example: :logs failures
:help
Open the generated keyboard help overlay. ? opens the same help.
Catalog description: show keyboard help
Arguments: none (extra words are ignored)
Example: :help
:q
Leave Ensemble deliberately and return the keys to the native OpenCode host. It does not quit OpenCode; Esc never quits.
Catalog description: leave Ensemble
Arguments: none (extra words are ignored)
Example: :q
/ composer catalog
The composer catalog contains 15 commands. It is not the same list as :; neither parser falls through to the other catalog.
| Command | Catalog description | Behavior |
|---|---|---|
/workspace | switch workspace | Open the workspace picker. |
/agent | mention an agent | Insert a $ agent mention into the composer. This is not the :agent picker. |
/settings | agent settings | Open agent Settings. |
/limits | dispatch hop limits | Open the dispatch-limits panel. |
/approvals | approval inbox | Open the full approval inbox. |
/pause | pause workspace | Pause the active workspace. |
/resume | resume workspace | Resume the active workspace. |
/init | initialize workspace files | Start a workspace-only, solo-only init job. Extra words are rejected. /ensemble-init is an accepted alias. |
/help | shortcut help | Open keyboard help. |
/native | open native session | Open the active agent's native session. |
/delegate | delegate selected subtask | Delegate the selected Work item. |
/retry | retry selected subtask | Retry the selected Work item. |
/restart | restart selected subtask | Restart the selected Work item. |
/cancel | cancel selected subtask | Cancel the selected Work item. |
/reset-ensemble | delete all Ensemble data | Delete all Ensemble data after typing RESET, then confirm whether to delete handoffs too. |
Composer examples
/workspace opens the workspace picker. /agent inserts a mention instead of opening a picker. /init and /ensemble-init run workspace init; /reset-ensemble is the destructive reset.
Semantic differences
:has no destructive command./has/reset-ensemble,/cancel, and the other selection actions, with their confirmations./has no:native-first,:tools,:logs,:q,:new-agent,:new-workspace, or:edit-workspace.:has no/delegate,/retry,/restart,/cancel, or/reset-ensemble.:initand/initboth work./ensemble-initworks;:ensemble-initdoes not exist.:native-first onsets the migration mode but does not clear an explicit legacy tool surface.:tools nativeis the restore.:initis solo-only. A:init <mention>or/initwith extra words is rejected before any job starts.
Next
- Keyboard reference: the overlay keys for
:logsand:limits. - Configuration: the settings that
:native-firstand:toolswrite.