Docs/Getting started

CLI reference

The dashboard and CLI share the same orchestration core. Use either interactively, or script every workflow.

Commands

clishakeOpen or reattach the interactive dashboard
clishake initInitialize .clishake/ and open the dashboard
clishake statusShow session, agents, tasks, and reconciliation
clishake agentsList the agent and sub-agent tree
clishake agent add <name>Register and start an agent
clishake agent start|stop|restart|removeControl an agent lifecycle
clishake agent set <name>Change an agent role or team at runtime
clishake send <@selector> <msg>Send an attributed message
clishake broadcast <msg>Message every live agent
clishake task createCreate and optionally assign a task
clishake tasksView the shared task board
clishake logs <name>View a rendered terminal or sanitized log
clishake events -fFollow the append-only audit stream
clishake approvalsReview, grant, or deny approval requests
clishake doctorDiagnose config, state, tmux, and adapters
clishake updateUpgrade to the latest tagged release

Message selectors

Selectors resolve against the live roster on every send. A bare selector uses name → role → team precedence.

@nameOne exact agent
@role:reviewerEvery agent currently in a role
@team:coreEvery member of a team
@task:task_ab12The task owner and contributors
@allEvery live agent

Dashboard keys

TabSwitch view
1–4Open a view
j / kSelect or scroll
@Start a message
/Start a command
F12Return from an agent pane
a / A / dAnswer harness dialogs
qQuit; agents keep running

Natural language plans

terminal
$ clishake ask "spin up a reviewer and inspect auth"
$ clishake ask --dry-run "split the open work"

ask reuses a locally installed Claude or Codex CLI, produces commands from a fixed whitelist, and shows the entire plan before execution.