Skip to main content

​
Dispatch Commands

Context-injecting spawn commands that bridge the wish state machine and agent spawn. Each command extracts relevant context from wish artifacts and injects it into the spawned agent.
Dispatch commands are thin wrappers around skills and spawn. genie wish, genie work, and genie review each resolve a skill (/wish, /work, /review), inject the relevant wish artifact as system-prompt context, and spawn the agent. If you need raw control, call genie spawn directly — dispatch exists so you don’t have to reconstruct that context by hand every time.

​
genie brainstorm

Spawn an agent with brainstorm DRAFT.md content.
Terminal

​
genie wish

Spawn an agent with DESIGN.md content.
Terminal

​
genie work

Check state, start execution group, spawn agent with wish context.
Terminal

​
genie review

Spawn a reviewer with group context and git diff.
Terminal

​
genie done

Mark an execution group as done, unblock dependents, push work, and notify the team lead on wave completion.
Terminal

​
Turn-closing commands

Called from inside an agent session to close the current turn with a non-success outcome. Both write the outcome (and optional reason) to the turn’s event log so the team lead and downstream tooling can act on it.

​
genie blocked

Close the current turn with outcome=blocked — use when the work cannot proceed because of an external dependency or missing information.
Terminal

​
genie failed

Close the current turn with outcome=failed — use when execution hit an error that cannot be recovered in this turn.
Terminal

​
genie status

Pretty-print wish state overview.
Terminal

​
genie reset

Reset wish state. <slug>#<group> resets one in-progress group; bare <slug> wipes the wish and recreates from current WISH.md.
Terminal
Bare genie reset <slug> wipes all group state — completed work, in-flight groups, review history — and recreates the wish from the current WISH.md. Use genie reset <slug>#<group> when you only need to rerun a single group.
genie status <slug> is the fastest pre-flight check before any dispatch command — it shows which groups are ready, in-progress, or blocked, so you don’t spawn a duplicate agent on a group that’s already running.

​
Context Injection

All dispatch commands inject:
  1. The file path to the full document (so the agent can read it)
  2. The extracted section content (so the agent has immediate context)
  3. Wish-level context when available (summary, scope, decisions)
Context is written to a temp file and passed via --append-system-prompt-file.

​
See also

Wish skill

Shape a draft idea into a structured WISH.md.

Work skill

Orchestrate the execution groups defined in a wish.

Review skill

Validate completed work against the wish’s acceptance criteria.

Spawn & Lifecycle

Spawn agents directly when you don’t need wish context.