claude-squad  by smtg-ai

Terminal app for managing multiple AI agents

Created 10 months ago
5,574 stars

Top 9.0% on SourcePulse

GitHubView on GitHub
Project Summary

Claude Squad is a terminal application designed to manage multiple AI coding assistants, such as Claude Code, Codex, and Aider, within isolated workspaces. It aims to boost developer productivity by enabling simultaneous work on different tasks, with features for background task execution, change review, and conflict-free code management.

How It Works

The application leverages tmux to create separate terminal sessions for each AI agent, ensuring isolation. It utilizes git worktrees to provide each session with its own distinct codebase and branch, preventing conflicts. A terminal UI (TUI) facilitates navigation and management of these sessions and tasks.

Quick Start & Requirements

  • Primary install: curl -fsSL https://raw.githubusercontent.com/stmg-ai/claude-squad/main/install.sh | bash
  • Prerequisites: tmux, gh (GitHub CLI)
  • Usage: cs
  • Configuration: API keys for assistants like Codex can be set via environment variables (e.g., export OPENAI_API_KEY=<your_key>).
  • Documentation: https://github.com/smtg-ai/claude-squad

Highlighted Details

  • Manages multiple AI agents (Claude Code, Codex, Aider) in separate, isolated workspaces.
  • Supports background task execution, including an experimental auto-accept mode (-y).
  • Allows reviewing and committing changes before pushing to GitHub.
  • Provides a TUI for session management, navigation, and interaction.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels are provided in the README.

Licensing & Compatibility

  • License: AGPL-3.0
  • Compatibility: The AGPL-3.0 license may impose copyleft restrictions on derivative works and linking, potentially impacting commercial or closed-source use.

Limitations & Caveats

The autoyes flag is marked as experimental. The README does not detail specific AI models supported beyond mentioning Claude Code, Codex, and Aider, nor does it provide performance benchmarks.

Health Check
Last Commit

2 weeks ago

Responsiveness

1 day

Pull Requests (30d)
7
Issues (30d)
17
Star History
302 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.