Squad AI

Manage your AI coding agent squad inside dev containers.

Lea este documento en español.

---

What It Does

Squad AI is a CLI that installs and manages AI coding agents (Claude Code, OpenCode, Pi, Codex, and more) inside dev containers. It replaces ad-hoc post-create.sh scripts with a single tool.

Before: copying curl | bash snippets between projects, keeping them in sync manually.
After: squad add → pick your agents → done. One command in postCreateCommand.

Quick Install

curl -fsSL https://raw.githubusercontent.com/alebak/squad-ai/main/scripts/install.sh | bash

This downloads the latest binary to ~/.local/bin/squad. Add it to your PATH if needed:

export PATH="$HOME/.local/bin:$PATH"

Usage

# First run: pick your agents interactively
squad add

# Install your selected agents silently
squad install

# Install specific agents (no TUI)
squad install --agents claude-code,opencode,gentle-ai

# See what's installed and available
squad list

# Update the agent registry
squad update

Dev Container Integration

Add to your .devcontainer/devcontainer.json:

{
  "postCreateCommand": "squad install"
}

Or use a post-create.sh for first-time setup:

#!/bin/bash
set -e

if ! command -v squad &>/dev/null; then
  curl -fsSL https://raw.githubusercontent.com/alebak/squad-ai/main/scripts/install.sh | bash
  export PATH="$HOME/.local/bin:$PATH"
fi

squad install

Config persists between container rebuilds when $HOME is mounted as a volume.

Supported Agents

Agent	Install Method	Runtime
Claude Code	curl | bash	none
OpenCode	curl | bash	none
Pi	curl | bash	none
Codex CLI	npm	Node.js
Antigravity CLI	curl | bash	none
Gemini CLI	npm	Node.js
Gentle AI	curl | bash	none

New agents are added via PR to registry/agents.json. Squad AI notifies you when new agents become available.

How It Works

1. Registry — a registry/agents.json file in this repo lists all available agents with install commands, runtime dependencies, and SHA-256 checksums.
2. Local cache — squad fetches and caches the registry locally (~/.config/squad-ai/registry.cache.json).
3. Detection — on squad list, it checks which agents are already installed and which runtimes are missing.
4. Installation — squad install runs the install commands, captures logs, verifies checksums, and saves your selection.
5. TUI — squad add opens a terminal UI where you browse, select, and install agents interactively.

Contributing

See CONTRIBUTING.md for the full workflow. Quick overview:

• Issue-first: open an issue before a PR
• Conventional Commits: feat(scope):, fix(scope):, docs:, etc.
• Branch naming: feat/, fix/, docs/, chore/
• Code standards: idiomatic Go, stdlib first, godoc on exports

Questions? Use Discussions, not issues.

License

MIT © Alebak