Using octomux

Tasks & the board

Dispatch a task, watch it, and move it through to merged — from the dashboard or the CLI.

Creating tasks

From the dashboard, describe the task and pick a harness. From the CLI:

octomux create-task -t "Add a regression test for the parser edge case" -r . \
  --harness claude-code -p "..."

Paste a tracker link and octomux pulls the ticket. Paste a list and you get one agent per line, each in its own worktree.

Multiple agents on one task

A task can hold more than one agent, sharing the worktree — useful for putting a reviewer alongside an implementer.

octomux add-agent --task <id>

The permission inbox

Every “allow this tool?” prompt from every agent collects in one inbox instead of scattering across terminal panes. Answer once and that agent keeps going. Standing answers can be saved as permission rules so the same prompt stops interrupting.

The monitor grid

Every running agent’s live terminal, tiled on one screen. It exists for one job: spotting the stuck one without opening ten panes.

Moving a task

octomux task-move <id> human_review
octomux task-summary <id> "Parser fix + regression test, ready to read"
octomux task-note <id> "Verify passed on the third pass"

If a tracker integration is configured, these moves mirror onto the linked ticket automatically.