{"id":27221467,"url":"https://github.com/smtg-ai/claude-squad","last_synced_at":"2026-10-17T04:03:28.016Z","repository":{"id":284851897,"uuid":"945605057","full_name":"smtg-ai/claude-squad","owner":"smtg-ai","description":"Manage multiple AI terminal agents like Claude Code, Codex, OpenCode, and Amp.","archived":false,"fork":false,"pushed_at":"2026-08-20T05:09:53.000Z","size":3441,"stargazers_count":8597,"open_issues_count":51,"forks_count":625,"subscribers_count":29,"default_branch":"main","last_synced_at":"2026-10-14T07:57:59.965Z","etag":null,"topics":["claude-code","cli","codex","opencode","vibe-coding"],"latest_commit_sha":null,"homepage":"https://smtg-ai.github.io/claude-squad/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smtg-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2025-03-09T20:00:41.000Z","updated_at":"2026-10-14T07:50:58.000Z","dependencies_parsed_at":"2025-04-17T01:20:25.594Z","dependency_job_id":"43e03588-d2c6-41bf-aae0-4770f84d0b5f","html_url":"https://github.com/smtg-ai/claude-squad","commit_stats":null,"previous_names":["stmg-ai/claude-squad","smtg-ai/claude-squad"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/smtg-ai/claude-squad","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smtg-ai%2Fclaude-squad","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smtg-ai%2Fclaude-squad/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smtg-ai%2Fclaude-squad/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smtg-ai%2Fclaude-squad/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smtg-ai","download_url":"https://codeload.github.com/smtg-ai/claude-squad/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smtg-ai%2Fclaude-squad/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344836268,"owners_count":38332409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-17T02:00:06.547Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","cli","codex","opencode","vibe-coding"],"created_at":"2025-04-10T08:01:02.307Z","updated_at":"2026-10-17T04:03:26.002Z","avatar_url":"https://github.com/smtg-ai.png","language":"Go","funding_links":[],"categories":["Terminal Multiplexers and Session Managers","框架扩展","Claude Code Ecosystem","Go","Multi-Agent \u0026 Orchestration","HarmonyOS","Agents \u0026 Agent Managers","🎉 New Entries","claude-code","Orchestration Frameworks","AI应用","Agent Orchestration","📊 The List","Multi-Agent Systems","🛠 Applications \u0026 Utilities","CLI Extensions and Companion Tools","Tools","Code \u0026 Developer Tools","13. Developer Tools \u0026 Integrations","🚀 AI Tools for Vim, Neovim, and Terminal","Harnesses \u0026 orchestration","Parallel Coding Agents — Terminal (TUI/CLI)","Catalog","AI Coding Agents","工具 🧰","📚 Tools","A01_文本生成_文本对话","CLI \u0026 Terminal Tools","Other"],"sub_categories":["Project \u0026 Session Management","Other IDEs","Windows Manager","Obsidian","Parallel Processing","MCP Frameworks and Tooling","Session Managers","Session managers \u0026 parallel runners","Harness Architecture \u0026 Orchestration","Claude Code","编排器","🌟 What You'll Find Here:","大语言对话模型及数据","Agent Orchestration","General Purpose Libraries"],"readme":"# Claude Squad [![CI](https://github.com/smtg-ai/claude-squad/actions/workflows/build.yml/badge.svg)](https://github.com/smtg-ai/claude-squad/actions/workflows/build.yml) [![GitHub Release](https://img.shields.io/github/v/release/smtg-ai/claude-squad)](https://github.com/smtg-ai/claude-squad/releases/latest)\n\n[Claude Squad](https://smtg-ai.github.io/claude-squad/) is a terminal app that manages multiple [Claude Code](https://github.com/anthropics/claude-code), [Codex](https://github.com/openai/codex), [Gemini](https://github.com/google-gemini/gemini-cli) (and other local agents including [Aider](https://github.com/Aider-AI/aider)) in separate workspaces, allowing you to work on multiple tasks simultaneously.\n\n\n![Claude Squad Screenshot](assets/screenshot.png)\n\n### Highlights\n- Complete tasks in the background (including yolo / auto-accept mode!)\n- Manage instances and tasks in one terminal window\n- Review changes before applying them, checkout changes before pushing them\n- Each task gets its own isolated git workspace, so no conflicts\n\n\u003cbr /\u003e\n\nhttps://github.com/user-attachments/assets/aef18253-e58f-4525-9032-f5a3d66c975a\n\n\u003cbr /\u003e\n\n### Installation\n\nBoth Homebrew and manual installation will install Claude Squad as `cs` on your system.\n\n#### Homebrew\n\n```bash\nbrew install claude-squad\nln -s \"$(brew --prefix)/bin/claude-squad\" \"$(brew --prefix)/bin/cs\"\n```\n\n#### Manual\n\nClaude Squad can also be installed by running the following command:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash\n```\n\nThis puts the `cs` binary in `~/.local/bin`.\n\nTo use a custom name for the binary:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash -s -- --name \u003cyour-binary-name\u003e\n```\n\n### Prerequisites\n\n- [tmux](https://github.com/tmux/tmux/wiki/Installing)\n- [gh](https://cli.github.com/)\n\n### Usage\n\n```\nUsage:\n  cs [flags]\n  cs [command]\n\nAvailable Commands:\n  completion  Generate the autocompletion script for the specified shell\n  debug       Print debug information like config paths\n  help        Help about any command\n  reset       Reset all stored instances\n  version     Print the version number of claude-squad\n\nFlags:\n  -y, --autoyes          [experimental] If enabled, all instances will automatically accept prompts for claude code \u0026 aider\n  -h, --help             help for claude-squad\n  -p, --program string   Program to run in new instances (e.g. 'aider --model ollama_chat/gemma3:1b')\n```\n\nRun the application with:\n\n```bash\ncs\n```\nNOTE: The default program is `claude` and we recommend using the latest version.\n\n\u003cbr /\u003e\n\n\u003cb\u003eUsing Claude Squad with other AI assistants:\u003c/b\u003e\n- For [Codex](https://github.com/openai/codex): Set your API key with `export OPENAI_API_KEY=\u003cyour_key\u003e`\n- Launch with specific assistants:\n   - Codex: `cs -p \"codex\"`\n   - Aider: `cs -p \"aider ...\"`\n   - Gemini: `cs -p \"gemini\"`\n- Make this the default, by modifying the config file (locate with `cs debug`)\n\n\u003cbr /\u003e\n\n#### Menu\nThe menu at the bottom of the screen shows available commands: \n\n##### Instance/Session Management\n- `n` - Create a new session\n- `N` - Create a new session with a prompt\n- `D` - Kill (delete) the selected session\n- `↑/j`, `↓/k` - Navigate between sessions\n\n##### Actions\n- `↵/o` - Attach to the selected session to reprompt\n- `ctrl-q` - Detach from session\n- `s` - Commit and push branch to github\n- `c` - Checkout. Commits changes and pauses the session\n- `r` - Resume a paused session\n- `?` - Show help menu\n\n##### Navigation\n- `tab` - Switch between preview tab and diff tab\n- `q` - Quit the application\n- `shift-↓/↑` - scroll in diff view\n\n### Configuration\n\nClaude Squad stores its configuration in `~/.claude-squad/config.json`. You can find the exact path by running `cs debug`.\n\n#### Profiles\n\nProfiles let you define multiple named program configurations and switch between them when creating a new session. When more than one profile is defined, the session creation overlay shows a profile picker that you can navigate with `←`/`→`.\n\nTo configure profiles, add a `profiles` array to your config file and set `default_program` to the name of the profile to select by default:\n\n```json\n{\n  \"default_program\": \"claude\",\n  \"profiles\": [\n    { \"name\": \"claude\", \"program\": \"claude\" },\n    { \"name\": \"codex\", \"program\": \"codex\" },\n    { \"name\": \"aider\", \"program\": \"aider --model ollama_chat/gemma3:1b\" }\n  ]\n}\n```\n\nEach profile has two fields:\n\n| Field     | Description                                              |\n|-----------|----------------------------------------------------------|\n| `name`    | Display name shown in the profile picker                 |\n| `program` | Shell command used to launch the agent for that profile  |\n\nIf no profiles are defined, Claude Squad uses `default_program` directly as the launch command (the default is `claude`).\n\n### FAQs\n\n#### Failed to start new session\n\nIf you get an error like `failed to start new session: timed out waiting for tmux session`, update the\nunderlying program (ex. `claude`) to the latest version.\n\n### How It Works\n\n1. **tmux** to create isolated terminal sessions for each agent\n2. **git worktrees** to isolate codebases so each session works on its own branch\n3. A simple TUI interface for easy navigation and management\n\n### License\n\n[AGPL-3.0](LICENSE.md)\n\n### Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=smtg-ai/claude-squad\u0026type=Date)](https://www.star-history.com/#smtg-ai/claude-squad\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmtg-ai%2Fclaude-squad","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmtg-ai%2Fclaude-squad","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmtg-ai%2Fclaude-squad/lists"}