# 使用 Homebrew 安装 claude-squad

查看 claude-squad 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:claude-squad
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install claude-squad
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:claude-squad
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/claude-squad>
- **版本:** 1.0.19
- **来源摘要:** Manage multiple AI agents like Claude Code, Aider and Codex in your terminal
- **主页:** <https://smtg-ai.github.io/claude-squad/>
- **仓库:** <https://github.com/smtg-ai/claude-squad>
- **上游文档:** <https://smtg-ai.github.io/claude-squad/>
- **许可证:** AGPL-3.0-only
- **源码归档:** <https://github.com/smtg-ai/claude-squad/archive/refs/tags/v1.0.19.tar.gz>
- **最后更新:** 2026-07-25T14:20:50-04:00
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- claude-squad (cli)
- claude-squad (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 1.0.19
- 管理器更新时间: 2026-07-25
- 本地数据: OK
- 上游仓库: https://github.com/smtg-ai/claude-squad
- 检测到的最新版本: v1.0.19 (当前)
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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`.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://github.com/smtg-ai/claude-squad>
- <https://formulae.brew.sh/api/formula/claude-squad.json>
- <https://api.github.com/repos/smtg-ai/claude-squad/releases/latest>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- 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:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** claude-squad
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## 相关链接

- [Source-control packages](https://pkg.so/zh-hans/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://pkg.so/zh-hans/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://pkg.so/zh-hans/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [cc-switch-cli](https://pkg.so/zh-hans/brew/cc-switch-cli/) - Shares pkgdb curated category or tags: ai, claude-code, cli, codex, orchestration.
- [gastown](https://pkg.so/zh-hans/brew/gastown/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, orchestration.
- [aoe](https://pkg.so/zh-hans/brew/aoe/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, orchestration.
- [oh-my-agent](https://pkg.so/zh-hans/brew/oh-my-agent/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, orchestration.
- [langgraph-cli](https://pkg.so/zh-hans/brew/langgraph-cli/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, orchestration.
- [ralph-orchestrator](https://pkg.so/zh-hans/brew/ralph-orchestrator/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, orchestration.
- [kagent](https://pkg.so/zh-hans/brew/kagent/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, orchestration.
- [cc-connect](https://pkg.so/zh-hans/brew/cc-connect/) - Shares pkgdb curated category or tags: ai, ai-agents, cli, orchestration.
- [claude-flow](https://pkg.so/zh-hans/npm/claude-flow/) - Local package facts share a topical domain. Shared terms: agents, ai, ai-agents, claude, claude-code.
- [claude-cmd](https://pkg.so/zh-hans/brew/claude-cmd/) - Package names and metadata indicate a similar tool family. Shared terms: agents, ai, claude, claude-code, cli.

## Combined YAML source

View the package source record on GitHub. [combined/claude-squad.yml](https://github.com/mxcl/pkgdb/blob/main/combined/claude-squad.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph