Skip to content

v0.1.0 - Initial Release

Latest
Latest

Choose a tag to compare

View all tags
@cj-vana cj-vana released this 13 Jan 02:17
v0.1.0
bdbb20e

Claude Swarm v0.1.0 - Initial Release

An MCP server that orchestrates parallel Claude Code worker swarms via tmux sessions.

Installation

One-liner install:

curl -fsSL https://raw.githubusercontent.com/cj-vana/claude-swarm/main/install.sh | bash

This will:

  • Clone the repo to ~/.claude-swarm
  • Install dependencies and build
  • Register the MCP server with Claude Code
  • Install the /swarm skill

Requirements

  • Node.js 18+
  • tmux (brew install tmux on macOS)
  • Claude Code CLI

Features

Core Orchestration

  • Parallel Worker Management - Spawn multiple Claude Code workers in isolated tmux sessions
  • Feature-based Task Breakdown - Break complex tasks into manageable features
  • Dependency Management - Control execution order with feature dependencies
  • Progress Tracking - Real-time progress monitoring with persistent state

Protocol Governance

  • Behavioral Constraints - Define protocols that govern worker behavior
  • Base Security Constraints - Immutable security boundaries (frozen at runtime)
  • Protocol Proposals - LLM-generated protocols with approval workflow
  • Protocol Networking - Share protocols across MCP instances

Worker Intelligence

  • Competitive Planning - Spawn dual planners for complex features, evaluate and select best approach
  • Confidence Monitoring - Multi-signal confidence scoring to detect struggling workers
  • Auto-retry - Automatic retry of failed features with configurable limits

Post-Completion Reviews

  • Code Review - Automated code quality review after feature completion
  • Architecture Review - Architectural analysis of changes
  • Review Implementation - Convert review findings into actionable features

Repository Setup

  • Project Analysis - Detect languages, frameworks, and existing configurations
  • Config Generation - Generate CI workflows, Dependabot, Release Please, issue templates
  • Multi-platform Support - GitHub, GitLab, Gitea, Bitbucket, Azure DevOps

Dashboard

  • Real-time Monitoring - Live terminal streaming with SSE
  • Feature Status - Visual cards showing progress, dependencies, worker assignment
  • Dark Mode - System preference detection

Security Highlights

  • ReDoS protection with safe regex testing
  • Path traversal prevention with symlink detection
  • Command allowlist enforcement
  • File-based prompt passing (not shell strings)
  • Fail-closed protocol enforcement

Usage

Use /swarm to build a REST API with authentication, user management, and tests

Or use the MCP tools directly:

  • orchestrator_init: Initialize a new swarm session
  • start_worker: Start a worker on a feature
  • check_all_workers: Monitor worker progress

Dashboard available at: http://localhost:3456 (when MCP server is active)

Full documentation available in README.md

Assets 2
Loading