OpenSwarm: Multi-Agent Claude CLI Orchestrator for Linear and GitHub

What OpenSwarm Does

OpenSwarm is an autonomous AI agent orchestrator powered by Claude Code CLI. It creates a multi-agent system that integrates with real development workflows, specifically Linear for issue tracking and GitHub for code management. The tool is designed to handle actual development tasks rather than toy examples.

Core Architecture and Features

The system follows a structured pipeline approach:

• Autonomous Pipeline: Cron-driven heartbeat fetches Linear issues and runs Worker/Reviewer pair loops
• Worker/Reviewer Pairs: Multi-iteration code generation with automated review, testing, and documentation stages
• Decision Engine: Scope validation, rate limiting, priority-based task selection, and workflow mapping
• Cognitive Memory: LanceDB vector store with Xenova/multilingual-e5-base embeddings for long-term recall across sessions
• Knowledge Graph: Static code analysis, dependency mapping, and impact analysis for smarter task execution
• Discord Control: Full command interface for monitoring, task dispatch, scheduling, and pair session management
• PR Auto-Improvement: Monitors open PRs, auto-fixes CI failures, auto-resolves merge conflicts, and retries until all checks pass
• Long-Running Monitors: Tracks external processes (training jobs, batch tasks) and reports completion
• Web Dashboard: Real-time status dashboard on port 3847 with PR Processor monitoring
• i18n Support: English and Korean locale support

Technical Requirements

• Node.js >= 22
• Claude Code CLI installed and authenticated (claude -p)
• Discord Bot token with message content intent
• Linear API key and team ID
• GitHub CLI (gh) for CI monitoring (optional)

Installation and Configuration

Basic setup:

git clone https://github.com/unohee/OpenSwarm.git
cd OpenSwarm
npm install

Configuration involves copying the example config and creating a .env file:

cp config.example.yaml config.yaml

Required .env variables:

DISCORD_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=your-channel-id
LINEAR_API_KEY=your-linear-api-key
LINEAR_TEAM_ID=your-linear-team-id

The config.yaml supports environment variable substitution (${VAR} or ${VAR:-default}) and is validated with Zod schemas. Key configuration sections include discord, linear, github, agents, autonomous, and prProcessor settings.

Current Status and Limitations

The creator notes this is still early software with rough edges. Current TODOs focus on safety, scaling, and better task decomposition. The system is currently powering the creator's solo dev workflow for trading infrastructure, LLM tools, and other projects.