====== Orca ======

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

[[https://github.com/stablyai/orca|Orca]] je open-source pracovní prostředí pro paralelní práci AI coding agentů. Není to vlastní AI model: spouští existující CLI agenty, například OpenCode, Claude Code nebo Codex, v samostatných Git worktree a sjednocuje jejich terminály, změny a review.

===== K čemu slouží =====

Orca řeší situaci, kdy je potřeba nad jedním repozitářem pracovat s více agenty zároveň. Každý agent dostane vlastní větev a vlastní adresář, takže si navzájem nepřepisují soubory. Výsledné změny je možné porovnat v diffu, vybrat vhodné řešení a ostatní worktree odstranit.

Praktický scénář je například porovnání několika přístupů ke stejnému úkolu:

  - jeden agent implementuje změnu,
  - druhý nezávisle hledá chyby nebo připraví review,
  - třetí zkouší alternativní návrh.

Orca tedy přidává koordinaci a dohled nad agenty; jejich model, účet, oprávnění a případné náklady zůstávají na straně použitého CLI nástroje.

===== Pracovní model =====

Základem jsou [[https://www.onorca.dev/docs/model/worktrees|Git worktree]]. Každý workspace má vlastní branch, soubory na disku a terminály. Vzniká z vybraného výchozího refu, typicky ''origin/main'', ale lze jej založit i z jiné větve nebo konkrétního commitu.

Typický postup:

  - Přidat lokální Git repozitář.
  - Vytvořit worktree pro konkrétní úkol.
  - V worktree vybrat a spustit agenta.
  - Nechat agenta pracovat a sledovat jeho terminál nebo stav.
  - Zkontrolovat diff proti výchozímu refu, případně vložit komentář přímo k řádku.
  - Vybranou změnu commitnout a odeslat; nevyužité worktree a jejich větve odstranit.

Nový worktree je čistý checkout. Ignorované soubory, například ''.env'', závislosti a cache, se nepřenášejí automaticky. Orca pro tento případ podporuje sdílené adresáře a soubor ''.worktreeinclude'' pro vybrané ignorované soubory.

===== Agenti a rozhraní =====

[[https://www.onorca.dev/docs/agents/supported|Podporovaní agenti]] zahrnují mimo jiné Claude Code, Codex, OpenCode, Gemini, Cursor CLI a další nástroje spustitelné v terminálu. Orca může spustit i vlastní CLI agenta; jeho přidaná hodnota je v jednotném rozhraní nad terminály, worktree a Git změnami.

Součástí aplikace je editor založený na Monaco, terminály s dělenými panely, prohlížeč, náhledy souborů a diff viewer. Změnu lze okomentovat přímo v diffu a připomínku poslat zpět agentovi.

===== Řízená orchestrace =====

[[https://www.onorca.dev/docs/cli/orchestration|Orchestrace]] je experimentální vrstva pro složitější víceagentní workflow. Pracuje s těmito pojmy:

  * **Run** – trvalý kontext běhu a inbox koordinátora.
  * **Task** – úkol se specifikací, závislostmi a stavem.
  * **Dispatch** – konkrétní pokus vykonat úkol v daném terminálu.
  * **Worker** – agent, který reportuje průběh, dokončení nebo problém.
  * **Decision gate** – rozhodnutí koordinátora, na kterém závisí další práce.

Tento režim se hodí pro workflow s návaznými úkoly a potřebou dohledatelného předání. Pro jednorázovou práci je jednodušší vytvořit worktree a poslat prompt přímo agentovi.

===== Vzdálený běh =====

[[https://www.onorca.dev/docs/ssh|SSH worktree]] umožňují vytvořit worktree a spustit agenty na vzdáleném stroji, zatímco editor, diff a ovládání zůstávají v lokální aplikaci. Pro dlouhodobě běžící prostředí existuje také [[https://www.onorca.dev/docs/remote-servers|Remote Orca Server]]: vzdálený počítač vlastní projekty, worktree, terminály i přihlášení agentů a klient se k němu připojuje přes privátní síť.

Pro headless Linux je k dispozici ''orca serve''. Podle [[https://github.com/stablyai/orca/blob/main/docs/reference/headless-linux-server.md|oficiálního návodu]] je podporovaný provoz zaměřený na Ubuntu a Debian s glibc alespoň 2.31; před nasazením na jiné distribuci je potřeba ověřit kompatibilitu AppImage a závislostí.

===== Bezpečnost a omezení =====

  * Worktree izolují změny v repozitáři, nejsou ale bezpečnostním sandboxem. Agent může stále spouštět příkazy, které mají dopad mimo pracovní adresář.
  * [[https://www.onorca.dev/docs/agents/supported|Výchozí nastavení oprávnění]] u podporovaných agentů předvyplňuje přepínače pro obcházení potvrzování příkazů. Pro citlivé projekty je vhodné v nastavení přepnout oprávnění na manuální režim nebo upravit parametry konkrétního agenta.
  * Orca používá lokálně nainstalované agenty a jejich účty. Nezajišťuje předplatné ani API přístup k modelům.
  * [[https://www.onorca.dev/docs/telemetry|Telemetrie]] v balíčkovaných sestaveních podle dokumentace neposílá prompty, výstupy agentů, názvy repozitářů, cesty ani obsah souborů. Lze ji vypnout v nastavení nebo proměnnými ''DO_NOT_TRACK=1'' a ''ORCA_TELEMETRY_DISABLED=1''.

===== Zdroje =====

  * [[https://github.com/stablyai/orca|Orca – GitHub repozitář a README]]
  * [[https://www.onorca.dev/docs/model/worktrees|Orca Docs – Worktrees]]
  * [[https://www.onorca.dev/docs/agents/supported|Orca Docs – Supported agents]]
  * [[https://www.onorca.dev/docs/cli/orchestration|Orca Docs – Orchestration]]
  * [[https://www.onorca.dev/docs/ssh|Orca Docs – SSH worktrees]]
  * [[https://www.onorca.dev/docs/remote-servers|Orca Docs – Remote Orca Servers]]
  * [[https://www.onorca.dev/docs/telemetry|Orca Docs – Privacy & Telemetry]]
  * [[https://github.com/stablyai/orca/blob/main/docs/reference/headless-linux-server.md|Orca – Headless Linux Server]]