How do I install the Swarm CLI skill?

Run npx skillmds@latest add joelhooks/swarm-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Swarm CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Swarm CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Swarm CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Swarm CLI?

joelhooks (@joelhooks) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Swarm CLI by joelhooks — Agent Skill

Name: Swarm CLI
Author: joelhooks

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.

joelhooks 2fd10a1 2.7 KB Updated Sep 17, 2026

File contents

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

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

---name: swarm-clidescription: 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)```bashswarm memory find "query" # Semantic search for learningsswarm memory find "query" --fts # Full-text search fallbackswarm memory store "info" --tags x # Store a learningswarm memory get <id> # Get specific memoryswarm 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)```bashswarm hive ready # Get next unblocked taskswarm hive query --status open # List open tasksswarm hive create "title" --type bug --priority 1swarm hive update <id> --status in_progressswarm hive close <id> "summary" # Close completed taskswarm tree # Visualize task hierarchy```## Coordination (Swarm Mail)```bashswarm mail inbox # Check for messagesswarm mail send "coordinator" "Subject" "Body"swarm mail reserve file.ts # Reserve file for editingswarm mail release # Release all reservations```## Progress & Checkpoints```bashswarm progress 50 "message" # Report 50% progressswarm checkpoint # Save context before risky opsswarm complete "summary" # Mark task done (releases locks)```## Analytics```bashswarm compliance # Check tool usage statsswarm history # Recent swarm activityswarm dashboard # Live worker status UI```## Core Workflow1. `swarm memory find "<task keywords>"` - Check for existing solutions2. `swarm hive ready` - Get your task3. `swarm mail reserve <files>` - Lock your files4. Do the work (TDD: red → green → refactor)5. `swarm progress 50 "message"` - Report milestones6. `swarm memory store "learning" --tags "domain"` - Store discoveries7. `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

Frequently asked questions