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 installConfiguration involves copying the example config and creating a .env file:
cp config.example.yaml config.yamlRequired .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-idThe 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.
📖 Read the full source: HN AI Agents
👀 See Also
Agent Image Skills: Simple Image Hosting for Claude Code Agents
A developer built a simple image hosting service at https://images.labnocturne.com to solve the problem of Claude Code agents generating images with nowhere to store them. The service provides instant test keys via curl, auto-deletes files after 7 days, and includes Claude Code MCP skills for upload, file listing, and deletion.
ThoughtDAG: An Editable Context Graph for LLM Conversations
ThoughtDAG turns LLM context into an editable graph, letting you branch, merge, and prune what the model sees. A pilot shows it can fix errors by removing outdated branches, reducing token counts.
LLM Cost Profiler: Open-source tool tracks API spending to make case for local models
LLM Cost Profiler is a Python tool that tracks every API call to OpenAI/Anthropic, showing exactly what you're spending and where. It exposes tasks that are overpriced relative to their complexity, providing concrete dollar amounts to justify moving to local models.
Claude Command Center v5.0.0 Adds Day-One Support for Fable 5 with Mid-Session Switching
Claude Command Center v5.0.0 adds first-class support for Anthropic's new Fable 5 tier, including mid-session model switching, a redesigned model picker, and a fix for versioned alias CLI errors.