swarmdo

Agent = Model + Harness. The model writes; the harness gives it tools, memory, loops, sandboxes, and controls so it can actually work. Swarmdo is the harness — the execution layer around Claude Code and Codex that adds 100+ specialized agents, coordinated swarms, self-learning memory, federated comms across machines, and enterprise security guardrails. So agents don't just run, they collaborate.

One npx swarmdo init gives Claude Code a nervous system: agents self-organize into swarms, learn from every task, remember across sessions, and — with federation — securely talk to agents on other machines without leaking data. You keep writing code. Swarmdo handles the coordination.

Self-Learning / Self-Optimizing Agent Architecture

User --> Swarmdo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Providers
                          ^                           |
                          +---- Learning Loop <-------+

New to Swarmdo? You don't need to learn 314 MCP tools or 26 CLI commands. After init, just use Claude Code normally — the hooks system automatically routes tasks, learns from successful patterns, and coordinates agents in the background.

📖 Background — where the name comes from

Swarmdo is now Swarmdo — named by the upstream author, who loves Rust, flow states, and building things that feel inevitable. The "Ru" is the the upstream author. The "flo" is working until 3am. Underneath, powered by Cognitum.One agentic architecture, running a supercharged Rust-based AI engine, embeddings, memory, and plugin system.

---

Quick Start

There are two different install paths with very different surface areas. Pick based on what you need (#1744):

	Claude Code Plugin	CLI install (npx swarmdo init)
What it gives you	Slash commands + skills + agent definitions per-plugin; swarmdo-core also registers the swarmdo MCP server	Full Swarmdo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon
Files in your workspace	Zero	.claude/, .swarmdo/, CLAUDE.md, helpers, settings
MCP server registered	Yes with swarmdo-core (via the plugin's .mcp.json); other plugins are commands/skills only	Yes
Hooks installed	No	Yes
Best for	Try Swarmdo without committing files to your workspace	Production use — everything works as documented

Path A — Claude Code Plugins (zero files in your repo)

# Add the marketplace
/plugin marketplace add SwarmDo/swarmdo

# Install core + any plugins you need
/plugin install swarmdo-core@swarmdo
/plugin install swarmdo-swarm@swarmdo
/plugin install swarmdo-rag-memory@swarmdo
/plugin install swarmdo-neural-trader@swarmdo

swarmdo-core registers the swarmdo MCP server (300+ tools) plus base agents and setup skills; the other plugins add their slash commands and agent definitions. Hooks and the daemon still require Path B.

📦 swarmdo-core has been submitted to Anthropic's Claude Code plugin directory (community marketplace). Once approved it will also be installable via /plugin install swarmdo-core@claude-community — no marketplace-add needed.

🔌 All 35 plugins

Core & Orchestration