Agent skill

swarm-cli

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.

View SKILL.md on GitHub Repository
Stars 603
Forks 50

Install this agent skill to your Project

npx add-skill https://github.com/joelhooks/swarm-tools/tree/main/packages/opencode-swarm-plugin/claude-plugin/skills/swarm-cli

SKILL.md

Swarm CLI Quick Reference

Memory (Hivemind)

bash
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)

bash
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)

bash
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

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

Analytics

bash
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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

joelhooks/swarm-tools

swarm-coordination

Multi-agent coordination patterns for OpenCode swarm workflows. Use when work benefits from parallelization or coordination. Covers: decomposition, worker spawning, file reservations, progress tracking, and review loops.

603 50
Explore
joelhooks/swarm-tools

ralph-supervisor

Ralph loop pattern - Claude supervises while Codex (gpt-5.3-codex) executes implementation work. Use for autonomous coding loops with fresh context per iteration, validation gates, and git-backed persistence. Tools: ralph_init, ralph_story, ralph_iterate, ralph_loop, ralph_status, ralph_cancel, ralph_review.

603 50
Explore
joelhooks/swarm-tools

always-on-guidance

Always-on rule-oriented guidance for claude-plugin agents. Use to align behavior, tool usage, and model-specific defaults while avoiding deprecated bd/cass references. Related skills: swarm-coordination, testing-patterns.

603 50
Explore
joelhooks/swarm-tools

swarm-coordination

Multi-agent coordination patterns for OpenCode swarm workflows. Use when working on complex tasks that benefit from parallelization, when coordinating multiple agents, or when managing task decomposition. Do NOT use for simple single-agent tasks.

603 50
Explore
joelhooks/swarm-tools

hive-workflow

Issue tracking and task management using the hive system. Use when creating, updating, or managing work items. Use when you need to track bugs, features, tasks, or epics. Do NOT use for simple one-off questions or explorations.

603 50
Explore
joelhooks/swarm-tools

skill-creator

Guide for creating effective agent skills. Use when you want to create a new skill, improve an existing skill, or learn best practices for skill development. Helps codify learned patterns into reusable, discoverable skills.

603 50
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results