swarm-tools
π Multi-agent swarm coordination for OpenCode with learning capabilities, agent issue tracking, and management
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/joelhooks/swarm-tools with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/joelhooks/swarm-tools'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/joelhooks--opencode-swarm-plugin)HTML
<a href="/listings/joelhooks--opencode-swarm-plugin"><img src="/api/listings/joelhooks--opencode-swarm-plugin/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
OpenCode
npm install -g opencode-swarm-plugin swarm setup
Done. Use `/swarm "your task"` in any OpenCode session.
Claude Code
**Step 1:** Install the CLI globally (required):
npm install -g opencode-swarm-plugin
**Step 2:** Add the marketplace in Claude Code:
/plugin β Manage marketplaces β Add marketplace β Enter: joelhooks/swarm-tools
**Step 3:** Install the plugin:
/plugin β Manage plugins β swarm-tools β swarm β Install
The MCP server starts automatically. Use `/swarm "your task"` in any session.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json Β· Manifest Β· 20 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "swarm-tools",
- "owner": {
- "name": "Joel Hooks"
- },
- "metadata": {
- "description": "Swarm Tools marketplace for Claude Code"
- },
- "plugins": [
- {
- "name": "swarm",
- "source": "./packages/claude-code-swarm-plugin",
- "description": "Multi-agent coordination for Claude Code (delegates to swarm CLI)",
- "version": "0.62.0",
- "author": {
- "name": "Joel Hooks"
- }
- }
- ]
- }
README.md Β· README Β· 243 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Swarm
- [](https://www.npmjs.com/package/opencode-swarm-plugin)
- [](https://swarmtools.ai/docs)
- ```
- βββββββββββ βββ ββββββ βββββββ ββββ ββββ
- βββββββββββ ββββββββββββββββββββββββ βββββ
- βββββββββββ ββ ββββββββββββββββββββββββββββββ
- βββββββββββββββββββββββββββββββββββββββββββββ
- βββββββββββββββββββββ ββββββ ββββββ βββ βββ
- ββββββββ ββββββββ βββ ββββββ ββββββ βββ
- ```
- **Multi-agent coordination that survives context death.**
- Break big tasks into small ones. Spawn agents to work in parallel. Learn from what works.
- > **[swarmtools.ai](https://swarmtools.ai)** Β· **[Documentation](https://swarmtools.ai/docs)**
- ---
- ## Installation
- ### OpenCode
- ```bash
- npm install -g opencode-swarm-plugin
- swarm setup
- ```
- Done. Use `/swarm "your task"` in any OpenCode session.
- ### Claude Code
- **Step 1:** Install the CLI globally (required):
- ```bash
- npm install -g opencode-swarm-plugin
- ```
- **Step 2:** Add the marketplace in Claude Code:
- ```
- /plugin
- β Manage marketplaces
- β Add marketplace
- β Enter: joelhooks/swarm-tools
- ```
- **Step 3:** Install the plugin:
- ```
- /plugin
- β Manage plugins
- β swarm-tools
- β swarm
- β Install
- ```
- The MCP server starts automatically. Use `/swarm "your task"` in any session.
- ---
- ## What It Does
- ```
- /swarm "Add user authentication with OAuth"
- ```
- 1. **Decomposes** the task into parallelizable subtasks
- 2. **Creates cells** in the Hive (git-backed task tracker)
- 3. **Spawns workers** with file reservations (no conflicts)
- 4. **Coordinates** via Swarm Mail (embedded event store)
- 5. **Reviews** each completion before approval
- 6. **Learns** what worked for next time
- ---
- ## Core Concepts
- ### Hive
- Git-backed task tracking in `.hive/`. Survives sessions, syncs via git.
- ```
- hive_create({ title: "Fix auth bug", type: "bug" })
- hive_cells({ status: "in_progress" })
- hive_close({ id: "cell-123", reason: "Fixed" })
- ```
- ### Hivemind
- Semantic memory with embeddings. Store learnings, search later.
- ```
- hivemind_store({ information: "Auth requires idempotency keys", tags: "auth,gotcha" })
- hivemind_find({ query: "auth patterns" })
- ```
- ### Swarm Mail
- Actor-model coordination between agents. File reservations, messaging, checkpoints.
- ```
- swarmmail_reserve({ paths: ["src/auth/*"], exclusive: true })
- swarmmail_send({ to: ["worker-b"], subject: "Need types", body: "..." })
- ```
- ---
- ## Commands
- | Command | Description |
- |---------|-------------|
- | `/swarm <task>` | Decompose and spawn parallel workers |
- | `/hive` | Query and manage tasks |
- | `/inbox` | Check messages from other agents |
- | `/status` | Swarm coordination status |
- | `/handoff` | End session with sync and handoff notes |
- ---
- ## CLI
- ```bash
- swarm setup # Configure OpenCode/Claude Code integration
- swarm doctor # Check dependencies (Ollama for embeddings)
- swarm init # Initialize hive in current project
- swarm config # Show config paths
- ```
- ---
- ## How It Works
- ```
- Your Task
- β
- βΌ
- ββββββββββββββββββ
- β COORDINATOR β
- β β
- β 1. Query past β
- β sessions β
- β 2. Pick strat β
- β 3. Decompose β
- ββββββββββββββββββ
- β
- βββββββββββββββββββΌββββββββββββββββββ
- βΌ βΌ βΌ
- ββββββββββββββ ββββββββββββββ ββββββββββββββ
- β Worker A β β Worker B β β Worker C β
- β β β β β β
- β π files βββββΆβ π files β β π files β
- ββββββββββββββ ββββββββββββββ ββββββββββββββ
- β β β
- βββββββββββββββββββΌββββββββββββββββββ
- βΌ
- ββββββββββββββββββ
- β LEARNING β
- β β
- β Record outcome β
- β Update weights β
- ββββββββββββββββββ
- ```
- ---
- ## Architecture
- Everything runs locally. No external servers.
- - **libSQL** - Embedded SQLite for event sourcing
- - **Hive** - Git-backed `.hive/` directory for tasks
- - **Hivemind** - Semantic memory with Ollama embeddings (falls back to FTS)
- - **Swarm Mail** - DurableMailbox, DurableLock, DurableDeferred primitives
- ### Event Sourcing
- All state is an append-only event log:
- ```
- agent_registered β Agent joins swarm
- message_sent β Agent-to-agent communication
- file_reserved β Exclusive lock acquired
- file_released β Lock released
- checkpoint β Progress snapshot
- outcome β Completion result
- ```
- ---
- ## Learning System
- Every completion records duration, errors, files touched, success.
- - **Patterns** mature: candidate β established β proven
- - **Anti-patterns** auto-generate when failure rate > 60%
- - **Confidence decays** over 90 days unless revalidated
- ---
- ## Dependencies
- | Required | Optional |
- |----------|----------|
- | [Bun](https://bun.sh) | [Ollama](https://ollama.ai) - local embeddings |
- Run `swarm doctor` to check status.
- ### Embedding Model Configuration
- Configure the embedding model via environment variables:
- ```bash
- export OLLAMA_MODEL=nomic-embed-text # Default: mxbai-embed-large
- export OLLAMA_HOST=http://localhost:11434 # Default
- ```
- Supported models: `mxbai-embed-large` (1024d), `nomic-embed-text` (768d), `all-minilm` (384d), `snowflake-arctic-embed` (1024d). See [swarm-mail docs](packages/swarm-mail/README.md#configuring-the-embedding-model) for details.
- ---
- ## Development
- ```bash
- bun install
- bun turbo build
- bun turbo test
- ```
- ---
- ## Credits
- - [MCP Agent Mail](https://github.com/Dicklesworthstone/mcp_agent_mail) - inspiration for multi-agent coordination
- - [Electric SQL](https://electric-sql.com) - durable streams patterns
- - [Superpowers](https://github.com/obra/superpowers) - verification patterns
- ---
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.