Skip to content

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.

CommandArgumentsBehavior
:settingsnoneOpen agent Settings for the active or selected agent.
:limitsnoneOpen 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.
:approvalsnoneOpen the full-height approval inbox.
:workspacenoneOpen the workspace picker and switch the active workspace.
:agentnoneOpen the agent picker and start a direct chat.
:new-agentnoneOpen the new-agent wizard.
:new-workspacenoneOpen the new-workspace wizard.
:edit-workspacenoneEdit the active workspace's members and leader.
:pausenonePause the active workspace. A paused workspace rejects new work.
:resumenoneResume the active workspace.
:initnoneStart 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.
:nativenoneOpen the active agent's native session.
:native-firston|off|shadowSet 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.
:toolsnative|legacySet 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>]
:helpnoneOpen the generated keyboard help overlay. ? opens the same help.
:qnoneLeave 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.

CommandCatalog descriptionBehavior
/workspaceswitch workspaceOpen the workspace picker.
/agentmention an agentInsert a $ agent mention into the composer. This is not the :agent picker.
/settingsagent settingsOpen agent Settings.
/limitsdispatch hop limitsOpen the dispatch-limits panel.
/approvalsapproval inboxOpen the full approval inbox.
/pausepause workspacePause the active workspace.
/resumeresume workspaceResume the active workspace.
/initinitialize workspace filesStart a workspace-only, solo-only init job. Extra words are rejected. /ensemble-init is an accepted alias.
/helpshortcut helpOpen keyboard help.
/nativeopen native sessionOpen the active agent's native session.
/delegatedelegate selected subtaskDelegate the selected Work item.
/retryretry selected subtaskRetry the selected Work item.
/restartrestart selected subtaskRestart the selected Work item.
/cancelcancel selected subtaskCancel the selected Work item.
/reset-ensembledelete all Ensemble dataDelete 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.
  • :init and /init both work. /ensemble-init works; :ensemble-init does not exist.
  • :native-first on sets the migration mode but does not clear an explicit legacy tool surface. :tools native is the restore.
  • :init is solo-only. A :init <mention> or /init with extra words is rejected before any job starts.

Next ​

Released under the MIT License.