OpenSwarm orchestrates autonomous AI development teams using the Claude Code CLI, integrating with Linear for issue tracking and Discord for control. It automates code generation, review, and PR improvements, leveraging a cognitive memory system for long-term recall, benefiting developers seeking to automate complex coding workflows.

How It Works

The system employs a cron-driven heartbeat to fetch Linear issues, which are then processed by a DecisionEngine. A PairPipeline orchestrates Worker and Reviewer agents (and optionally Tester/Documenter) using pluggable CLI adapters (Claude, Codex). Code changes are iterated upon, reviewed, and updated in Linear, with progress reported to Discord. A hybrid retrieval memory system (LanceDB + Xenova embeddings) stores context across sessions.

Quick Start & Requirements

• Primary install: npm install -g @intrect/openswarm
• Run TUI: openswarm
• Prerequisites: Node.js >= 22, authenticated Claude Code CLI (claude -p), Discord Bot token with message content intent, Linear API key and team ID, GitHub CLI (optional).
• Setup: Requires cloning the repo, npm install, copying config.example.yaml to config.yaml, and setting up a .env file with API keys.
• Links: Official quick-start via CLI commands and config examples in README.

Highlighted Details

• Multi-Provider Adapters: Supports Claude Code CLI and OpenAI Codex CLI, with runtime switching via Discord command.
• Autonomous Pipeline: Automates fetching Linear issues, running Worker/Reviewer pairs, and updating issue states.
• Cognitive Memory: Utilizes LanceDB with Xenova embeddings for hybrid retrieval (similarity, importance, recency, frequency) and long-term recall.
• Discord Control: Comprehensive command interface for monitoring, task dispatch, scheduling, and agent management.
• PR Auto-Improvement: Monitors PRs, automatically fixes CI failures, and resolves merge conflicts.

Maintenance & Community

No specific details on contributors, sponsorships, or dedicated community channels (e.g., Discord/Slack) are provided beyond the GitHub repository itself.

Licensing & Compatibility

• License: MIT.
• Compatibility: Permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

The tester and documenter agent roles are disabled by default. Autonomous operation requires significant configuration and API key setup. The system relies on external CLIs (Claude, Codex) which must be authenticated and accessible.