# Install claude-squad with Homebrew Manage multiple AI agents like Claude Code, Aider and Codex in your terminal. Version 1.0.19 via Homebrew; verified 2026-06-17. ## Install ```sh sudo av install brew:claude-squad ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install claude-squad ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:claude-squad - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.0.19 - **Source summary:** Manage multiple AI agents like Claude Code, Aider and Codex in your terminal - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** AGPL-3.0-only - **Source archive:** - **Last updated:** 2026-06-17T15:13:31Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - claude-squad (cli) - claude-squad (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.0.19 - Package-manager updated: 2026-06-17 - Local data: ok - Upstream repository: https://github.com/smtg-ai/claude-squad - Upstream latest detected: v1.0.19 (current) ## Project history and usage Claude Squad is a terminal TUI for managing multiple AI coding agents in separate workspaces. The official README describes it as a way to run Claude Code, Codex, Gemini, Aider, and other local agents simultaneously, using tmux sessions and git worktrees to isolate each task. ### Project history Claude Squad belongs to the agent-orchestration layer that appeared after terminal coding agents became practical daily tools. Instead of providing a model or coding agent itself, it manages several agent sessions, previews their diffs, and helps users check out or push the resulting branches. The README documents a deliberately Unix-native architecture: tmux for isolated terminal sessions, git worktrees for conflict-free branches, and the GitHub CLI for pull-request-oriented workflows. Its default program is `claude`, but users can launch Codex, Aider, Gemini, or custom programs with the `-p` flag or profiles in the config file. ### Adoption history The project is distributed through Homebrew and a manual shell installer. Homebrew packages stable version 1.0.19 from the official GitHub tag archive and also exposes a `head` build from the main branch. The official GitHub release API records v1.0.19 published on June 17, 2026. The README also documents installation as `claude-squad` with an optional `cs` symlink, plus a manual installer that places the binary in `~/.local/bin`. ### How it is used Users run `cs` to open the TUI, create or attach to sessions, review diffs, commit and push branches, pause or resume sessions, and switch between preview and diff tabs. The default agent command is `claude`, while `cs -p "codex"`, `cs -p "aider ..."`, and `cs -p "gemini"` launch other assistants. Configuration lives at `~/.claude-squad/config.json`; the README documents `cs debug` as the way to find the exact path and profiles as the way to persist named agent commands. ### Why package nerds care Claude Squad is package-nerd significant because it packages orchestration around existing local CLIs rather than yet another model client. It treats tmux, git worktrees, gh, and agent binaries as composable dependencies in a single TUI workflow. Its Homebrew formula is also an example of the new AI-agent tooling stack entering conventional package managers: users install one binary, then combine it with separately packaged agents such as Claude Code, Codex, Aider, and Gemini. ### Timeline - 2026-06-17: GitHub release API records Claude Squad v1.0.19. - 2026: Homebrew formula `claude-squad` packages v1.0.19 from the official GitHub tag archive. - 2026: The README documents Claude Code, Codex, Gemini, and Aider profiles with tmux and git-worktree isolation. ### Related projects - Claude Code is the default program Claude Squad launches. - Codex, Gemini CLI, and Aider are named by the README as supported local agent programs. - tmux, git worktrees, and the GitHub CLI are required or central tools in the documented architecture. ### Sources - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.claude-squad/config.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** claude-squad - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [claude-cmd](https://www.automicvault.com/pkg/brew/claude-cmd/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claude-code-router](https://www.automicvault.com/pkg/brew/claude-code-router/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claude-code-templates](https://www.automicvault.com/pkg/brew/claude-code-templates/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claude-hooks](https://www.automicvault.com/pkg/brew/claude-hooks/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claudekit](https://www.automicvault.com/pkg/brew/claudekit/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [codex-acp](https://www.automicvault.com/pkg/brew/codex-acp/) - Shares av.db curated category or tags: ai-coding, cli, codex, developer-tools. - [omnara](https://www.automicvault.com/pkg/brew/omnara/) - Shares av.db curated category or tags: ai-agents, claude-code, cli, codex, developer-tools. - [sequin](https://www.automicvault.com/pkg/brew/sequin/) - Shares av.db curated category or tags: cli, developer-tools, terminal, tui. ## Combined YAML source View the package source record on GitHub. [combined/claude-squad.yml](https://github.com/automic-vault/db/blob/main/combined/claude-squad.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph