| name | swarm-cli |
| description | Swarm CLI commands for workers - hivemind memory, hive tasks, swarmmail coordination.
Use when working in a swarm context. Covers: swarm memory (find/store/get/stats),
swarm cells (query/create/update/close), and coordination commands.
|
Swarm CLI Quick Reference
Memory (Hivemind)
swarm memory find "query"
swarm memory find "query" --fts
swarm memory store "info" --tags x
swarm memory get <id>
swarm memory stats
When to query:
- BEFORE starting any task - check for existing solutions
- When stuck - search for similar problems
- Before major decisions - find past rationale
When to store:
- Solved a tricky bug (>15min debugging)
- Found a project-specific pattern
- Discovered a tool/library gotcha
- Made an architectural decision
Task Tracking (Hive)
swarm hive ready
swarm hive query --status open
swarm hive create "title" --type bug --priority 1
swarm hive update <id> --status in_progress
swarm hive close <id> "summary"
swarm tree
Coordination (Swarm Mail)
swarm mail inbox
swarm mail send "coordinator" "Subject" "Body"
swarm mail reserve file.ts
swarm mail release
Progress & Checkpoints
swarm progress 50 "message"
swarm checkpoint
swarm complete "summary"
Analytics
swarm compliance
swarm history
swarm dashboard
Core Workflow
swarm memory find "<task keywords>" - Check for existing solutions
swarm hive ready - Get your task
swarm mail reserve <files> - Lock your files
- Do the work (TDD: red → green → refactor)
swarm progress 50 "message" - Report milestones
swarm memory store "learning" --tags "domain" - Store discoveries
swarm complete "summary" - Finish and release locks
Tips
- Query before coding - 90% of problems have been solved before
- Store actionable learnings - Include WHY, not just WHAT
- Reserve files early - Prevents edit conflicts with other workers
- Report progress - Silent workers look stuck
- Checkpoint before risky ops - Saves context for recovery