====== Squad ======

//Vytvořeno: **7.7.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/mco-org/squad|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ů:

<code bash>
# Homebrew na macOS
brew install mco-org/tap/squad

# Build ze zdrojů
cargo install --git https://github.com/mco-org/squad.git
</code>

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:

<code bash>
squad setup
squad init
</code>

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

<code bash>
/squad manager
/squad worker
/squad inspector
</code>

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:

<code>
.squad/messages.db
</code>

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:

<code bash>
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"
</code>

Pro volnou komunikaci slouží ''send'' a ''receive'':

<code bash>
squad send manager worker "API contract changed"
squad receive worker --json
squad send manager @all "Update your implementations"
</code>

===== Role a týmy =====

Role jsou markdown soubory v adresáři:

<code>
.squad/roles/
</code>

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ů:

<code bash>
# 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
</code>

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

===== Zdroje =====

  * [[https://github.com/mco-org/squad|Squad – GitHub repozitář]]
  * [[https://mco-org.github.io/squad/|Squad – projektová stránka]]