# 使用 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
- **版本:** 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>
- **最后更新:** 2026-07-25T14:20:50-04:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- claude-squad (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.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

## 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
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph