Squad

Vytvořeno: 7.7.2026 | Aktualizováno: 07.07.2026 23:47

Squad je Rust CLI nástroj pro spolupráci více AI agentů v terminálu. Umožňuje spustit několik agentů v samostatných terminálech, přiřadit jim role a koordinovat práci přes lokální SQLite databázi bez démona, serveru nebo síťové služby.

K čemu slouží

Squad řeší jednoduchou multi-agentní koordinaci nad existujícími AI CLI nástroji. Typický scénář je jeden agent jako manager, jeden nebo více workerů a volitelně inspector pro kontrolu výsledků.

Hlavní principy:

každý agent běží ve vlastním terminálu,
komunikace probíhá přes soubor .squad/messages.db,
příkazy jsou jednorázové operace nad SQLite,
není potřeba spouštět žádný server ani background proces,
agenti si předávají zprávy a strukturované úkoly přes CLI.

Podporované AI CLI nástroje podle README:

Claude Code,
Gemini CLI,
Codex CLI,
OpenCode.

Instalace

README uvádí instalaci přes Homebrew, GitHub Releases nebo build ze zdrojů:

# Homebrew na macOS
brew install mco-org/tap/squad
 
# Build ze zdrojů
cargo install --git https://github.com/mco-org/squad.git

Pro build ze zdrojů projekt uvádí Rust 1.77+.

Základní použití

Nejprve se nainstaluje slash command pro podporované AI nástroje a inicializuje se workspace:

squad setup
squad init

Potom se v jednotlivých AI CLI terminálech spustí role:

/squad manager
/squad worker
/squad inspector

Manager má rozložit cíl na úkoly, worker úkoly provádí a inspector kontroluje výsledek. Pokud se připojí více agentů se stejným ID, Squad je automaticky odliší příponou, například worker, worker-2, worker-3.

Jak funguje komunikace

Všechny zprávy a úkoly jsou uložené v lokální SQLite databázi:

.squad/messages.db

Agent si může zkontrolovat inbox, čekat na zprávu, poslat zprávu jinému agentovi nebo vytvořit strukturovaný úkol. Pro úkoly se používá tok create → ack → complete:

squad task create manager worker --title "auth-module" --body "implement auth module with JWT"
squad task ack worker <task-id>
squad task complete worker <task-id> --summary "JWT auth shipped"

Pro volnou komunikaci slouží send a receive:

squad send manager worker "API contract changed"
squad receive worker --json
squad send manager @all "Update your implementations"

Role a týmy

Role jsou markdown soubory v adresáři:

.squad/roles/

Vestavěné role:

manager – rozděluje cíle na úkoly a koordinuje práci,
worker – provádí přidělené úkoly a reportuje výsledek,
inspector – kontroluje výsledek a vrací verdikt.

Vlastní role se přidá jako další markdown soubor do .squad/roles/. Týmy jsou YAML soubory v .squad/teams/ a určují, které role se mají pro dané workflow použít.

Důležité příkazy

Přehled nejdůležitějších příkazů:

# workspace
squad init
squad setup
squad clean
 
# agenti
squad join <id> --role <role>
squad leave <id>
squad agents --json
 
# zprávy
squad send <from> <to> "message"
squad receive <id> --wait
squad pending
squad history
 
# úkoly
squad task create <from> <to> --title "title" --body "body"
squad task ack <agent> <task-id>
squad task complete <agent> <task-id> --summary "summary"
squad task requeue <task-id>
squad task list

Poznámky

Squad je vhodný hlavně pro lokální terminálové workflow, kde má smysl ručně nebo skriptem spouštět více agentů vedle sebe. Výhoda je jednoduchost: komunikace je obyčejný SQLite soubor a celý systém je dobře kontrolovatelný. Nevýhoda je, že nejde o plnohodnotný distribuovaný orchestrátor; projekt podle README záměrně nestaví serverovou runtime vrstvu ani message broker.

Volitelný tmux launcher je oddělený od hlavního Rust CLI. Slouží k opakovatelnému spuštění více terminálových panelů a vyžaduje tmux, ruby a claude.

Obsah