# squad-station

> Message routing and orchestration for AI agent squads

- **URL**: https://www.freshcrate.ai/projects/squad-station
- **Author**: tranthien
- **Category**: Frameworks
- **Latest version**: `v0.10.0` (2026-04-24)
- **License**: MIT
- **Source**: https://github.com/thientranhung/squad-station
- **Homepage**: https://github.com/thientranhung/squad-station#readme
- **Language**: Rust
- **GitHub**: 1 stars
- **Registry**: npm (`squad-station`)
- **Tags**: `agents`, `ai`, `claude`, `cli`, `gemini`, `npm`, `orchestration`, `squad`, `tmux`

## Description

Message routing and orchestration for AI agent squads

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.10.0` | 2026-04-24 | High | Validate agent model IDs at `squad-station init` against a provider-scoped whitelist, and ship a human-readable `.squad/models.md` reference so users can discover and pick valid IDs without guessing. Addresses the class of silent failures where an invalid model in `squad.yml` would only surface at runtime.  ### Added - `valid_models_for(provider)` whitelist in `src/config.rs` covering Claude Code, Codex, and Gemini CLI with verified model IDs (sourced from official docs; speculative IDs removed |
| `0.9.1` | 2026-04-21 | Low | Imported from npm (0.9.1) |
| `v0.9.1` | 2026-04-10 | Medium | Detect and auto-repair stale squad-station hook binary paths in `.claude/settings.json`. Resolves a class of failures where hooks point to moved or deleted binaries (e.g. after upgrading from `~/.cargo/bin` to `~/.squad/bin` in v0.8.17).  ### Added - New `src/hook_parser.rs` module: `extract_binary_path`, `is_stale`, `heal_stale_squad_paths` - `squad-station doctor` Hooks check now has a phase-2 scan that validates each hook's binary exists and is executable; reports `[FAIL]` with location (`St |
| `v0.9.1` | 2026-04-10 | Medium | Detect and auto-repair stale squad-station hook binary paths in `.claude/settings.json`. Resolves a class of failures where hooks point to moved or deleted binaries (e.g. after upgrading from `~/.cargo/bin` to `~/.squad/bin` in v0.8.17).  ### Added - New `src/hook_parser.rs` module: `extract_binary_path`, `is_stale`, `heal_stale_squad_paths` - `squad-station doctor` Hooks check now has a phase-2 scan that validates each hook's binary exists and is executable; reports `[FAIL]` with location (`St |
| `v0.9.1` | 2026-04-10 | Medium | Detect and auto-repair stale squad-station hook binary paths in `.claude/settings.json`. Resolves a class of failures where hooks point to moved or deleted binaries (e.g. after upgrading from `~/.cargo/bin` to `~/.squad/bin` in v0.8.17).  ### Added - New `src/hook_parser.rs` module: `extract_binary_path`, `is_stale`, `heal_stale_squad_paths` - `squad-station doctor` Hooks check now has a phase-2 scan that validates each hook's binary exists and is executable; reports `[FAIL]` with location (`St |
| `v0.9.1` | 2026-04-10 | Medium | Detect and auto-repair stale squad-station hook binary paths in `.claude/settings.json`. Resolves a class of failures where hooks point to moved or deleted binaries (e.g. after upgrading from `~/.cargo/bin` to `~/.squad/bin` in v0.8.17).  ### Added - New `src/hook_parser.rs` module: `extract_binary_path`, `is_stale`, `heal_stale_squad_paths` - `squad-station doctor` Hooks check now has a phase-2 scan that validates each hook's binary exists and is executable; reports `[FAIL]` with location (`St |
| `v0.9.0` | 2026-04-10 | Medium | Health-check tooling for squad-station projects: validate SDD playbooks during init, and diagnose setup issues with the new doctor subcommand.  ### Added - `squad-station doctor` subcommand — runs 6 health checks (config, SDD playbooks, tmux, database, hooks, version) with `--json` support - `sdd-playbook` config field in squad.yml — declare required SDD playbooks (bmad, superpowers, gsd, openspec) - SDD playbook validation during `squad-station init` — blocks init if declared playbooks are not |
| `v0.8.22` | 2026-04-06 | Medium | Fix PATH auto-setup to use `.zshenv` instead of `.zshrc` so Claude Code agents in tmux sessions can find the `squad-station` binary. Non-interactive shells (used by Claude Code's Bash tool) only source `.zshenv`, not `.zshrc`.  ### Fixed  - **PATH setup uses `.zshenv`** — On macOS, install now writes `export PATH` to `~/.zshenv` instead of `~/.zshrc`, ensuring AI agents in tmux sessions can find `squad-station` binary in non-interactive shells - **Settings.json uses relative binary name** — Hoo |
| `v0.8.21` | 2026-04-06 | Medium | Improved install reliability: auto-adds PATH to shell profile, ignores npx cache wrappers in duplicate detection, and makes init more resilient.  ### Fixed  - **Auto PATH setup** — Install now auto-appends `~/.squad/bin` to shell profile (`~/.zshrc`/`~/.bashrc`) instead of just printing instructions - **npx cache bypass** — `verifyInPath` and `checkDuplicateBinary` now ignore npx cache / `node_modules/.bin` wrappers when checking PATH - **Resilient init** — `squad-station init` handles edge cas |
| `v0.8.20` | 2026-04-06 | Medium | Release v0.8.20 |

## Citation

- HTML: https://www.freshcrate.ai/projects/squad-station
- Markdown: https://www.freshcrate.ai/projects/squad-station.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/squad-station/deps

_Generated by freshcrate.ai. Indexes npm releases for AI-agent ecosystem packages._