| List agents | synapse list for humans (auto-refresh, interactive: arrows/1-9 select, Enter jump, k kill, / filter). For AI/scripts use synapse list --json, synapse list --plain, or MCP list_agents |
| Agent detail | synapse status <target> [--json] |
| Stuck-agent watchdog (Stage 1) | synapse watchdog check [--alarm-only] [--json] (one-shot heuristic scan; #646) |
| Send message | synapse send <target> "<msg>" (default: --notify; --from auto-detected) |
| Broadcast | synapse broadcast "<msg>" |
| Wait for reply | synapse send <target> "<msg>" --wait |
| Fire-and-forget | synapse send <target> "<msg>" --silent |
| Reply | synapse reply "<response>" |
| Reply to specific | synapse reply "<response>" --to <sender_id> |
| Reply with failure | synapse reply --fail "<reason>" |
| Interrupt (priority 4) | synapse interrupt <target> "<msg>" |
| Send keys to PTY (escape hatch for TUI dialogs; #695) | synapse send-keys <target> <keys> (e.g. a for codex "don't ask again", \r for Enter; bypasses A2A — use when an agent is stuck on an interactive dialog without synapse jump) |
| Spawn agent | synapse spawn <type> --name <n> --role "<r>" -- <tool-specific-automation-args> |
| Spawn + send first task (preferred for delegation) | synapse spawn <type> --name <n> --role "<r>" --task-file <path> --task-timeout 600 --notify |
| Spawn with worktree | synapse spawn <type> --worktree --name <n> --role "<r>" -- <tool-specific-automation-args> |
| Team start | synapse team start <homogeneous-profiles...> [--worktree] -- <tool-specific-automation-args> |
| Approve plan | synapse approve <id> |
| Reject plan | synapse reject <id> --reason "<feedback>" |
| Save knowledge | synapse memory save <key> "<content>" --tags <t> --notify |
| Search knowledge | synapse memory search "<query>" |
| Lock file | synapse file-safety lock <file> <agent_id> --intent "..." |
| Check locks | synapse file-safety locks |
| Task history | synapse history list --agent <name> |
| Kill agent | synapse kill <name> -f |
| Cleanup orphans | synapse cleanup --dry-run (list); synapse cleanup -f (kill all orphans whose parent crashed/cleared) |
| Attach files | synapse send <target> "<msg>" --attach <file> --wait |
| Saved agents | synapse agents list / synapse agents set <profile> / synapse agents unset <profile> / synapse agents roles / synapse spawn <agent_id>; live agents expose agent_definition_id as a stable target alias |
| Shared session handoff | synapse session publish <name> / synapse session import <name> using SYNAPSE_SHARED_SESSION_DIR |
| Post to Canvas | synapse canvas post <format> "<body>" --title "<title>" |
| Link preview | synapse canvas link "<url>" --title "<title>" |
| Post template | synapse canvas briefing '<json>' --title "<title>" |
| Post plan card | synapse canvas plan '<json>' --title "<title>" (Mermaid DAG + step list with status tracking) |
| Open Canvas | synapse canvas open (auto-starts server, opens browser) |
| Restart Canvas | synapse canvas restart (stop + start; use when canvas status reports ⚠ STALE after upgrade) |
| Sync workflow skills | synapse workflow sync (regenerate skills from workflow YAMLs, remove orphans) |
| Run workflow (auto-spawn) | synapse workflow run <name> --auto-spawn (supports DAG steps with depends_on and condition) |
| Multi-agent patterns | synapse map init/list/show/run/status/stop (built-in: generator-verifier, orchestrator-subagent, agent-teams, message-bus, shared-state) |
| Wiki ingest | synapse wiki ingest <source> [--scope project|global] (ingest a source file into the wiki) |
| Wiki query | synapse wiki query "<question>" [--scope project|global] (search wiki pages) |
| Wiki lint | synapse wiki lint [--scope project|global] (validate wiki consistency) |
| Wiki status | synapse wiki status [--scope project|global] (show wiki index stats) |
