Agent-Skills.md

Agent Skills: Swarm CLI Quick Reference

|

UncategorizedID: joelhooks/swarm-tools/swarm-cli

Repository

joelhooks/swarm-tools
joelhooks
40937

Install this agent skill to your local

pnpm dlx add-skill https://github.com/joelhooks/swarm-tools/tree/HEAD/packages/opencode-swarm-plugin/claude-plugin/skills/swarm-cli

Skill Files

Browse the full folder contents for swarm-cli.

Download Skill

Loading file tree…

packages/opencode-swarm-plugin/claude-plugin/skills/swarm-cli/SKILL.md

Skill Metadata

Name
swarm-cli
Description
|

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