/swarm-cli

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"           # Semantic search for learnings
swarm memory find "query" --fts     # Full-text search fallback
swarm memory store "info" --tags x  # Store a learning
swarm memory get <id>               # Get specific memory
swarm memory stats                  # Check memory health

**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                    # Get next unblocked task
swarm hive query --status open      # List open tasks
swarm hive create "title" --type bug --priority 1
swarm hive update <id> --status in_progress
swarm hive close <id> "summary"     # Close completed task
swarm tree                          # Visualize task hierarchy

Coordination (Swarm Mail)

swarm mail inbox                    # Check for messages
swarm mail send "coordinator" "Subject" "Body"
swarm mail reserve file.ts          # Reserve file for editing
swarm mail release                  # Release all reservations

Progress & Checkpoints

swarm progress 50 "message"         # Report 50% progress
swarm checkpoint                    # Save context before risky ops
swarm complete "summary"            # Mark task done (releases locks)

Analytics

swarm compliance                    # Check tool usage stats
swarm history                       # Recent swarm activity
swarm dashboard                     # Live worker status UI

Core Workflow

1. `swarm memory find "<task keywords>"` - Check for existing solutions 2. `swarm hive ready` - Get your task 3. `swarm mail reserve <files>` - Lock your files 4. Do the work (TDD: red → green → refactor) 5. `swarm progress 50 "message"` - Report milestones 6. `swarm memory store "learning" --tags "domain"` - Store discoveries 7. `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