====== Kimaki ======

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

[[https://github.com/remorses/kimaki|Kimaki]] je Discord bot a CLI nástroj pro ovládání [[https://opencode.ai|OpenCode]] coding sessions přímo z Discordu. Prakticky z Discord kanálu vznikne ovládací rozhraní pro AI agenta, který běží na lokálním počítači nad konkrétním projektem. Projekt má i domovskou stránku [[https://kimaki.dev|kimaki.dev]].

===== Co Kimaki řeší =====

Kimaki propojuje Discord s OpenCode. Uživatel napíše zprávu do Discord kanálu a Kimaki na lokálním stroji spustí nebo znovu použije OpenCode session, která může pracovat s kódem v přiřazeném adresáři.

Základní model podle README projektu:

  * každý Discord kanál je napojený na jeden projektový adresář na počítači,
  * každá session běží jako Discord thread,
  * Kimaki CLI běží lokálně a funguje jako most mezi Discordem a OpenCode serverem,
  * OpenCode agent může číst a upravovat soubory, spouštět terminálové příkazy, hledat v codebase a používat nakonfigurované nástroje.

Autor projektu to popisuje jako „texting your codebase“ — zadání se píše do Discordu a agent provádí změny v projektu.

===== Instalace a režimy provozu =====

Základní spuštění je přes npm/npx:

<code bash>
npx -y kimaki@latest
</code>

CLI provede interaktivním setupem. Projekt popisuje dva režimy:

  * **Gateway mode** — výchozí a doporučená varianta. Použije se předpřipravený Kimaki Discord bot, takže není potřeba ručně zakládat aplikaci v Discord Developer Portal.
  * **Self-hosted mode** — uživatel si vytvoří vlastního Discord bota na [[https://discord.com/developers/applications|Discord Developer Portal]]. Hodí se, pokud chce mít plnou kontrolu nad identitou bota.

Po nastavení musí Kimaki CLI zůstat spuštěné, protože tvoří spojení mezi Discordem a lokálním strojem.

===== Hlavní funkce =====

==== Zprávy, přílohy a hlas ====

Kimaki zpracovává běžné textové zprávy v kanálu napojeném na projekt. Kromě textu umí do kontextu session přidat i přílohy, například obrázky nebo soubory s kódem.

Podporované jsou i hlasové zprávy. Ty se podle dokumentace přepisují přes Gemini API a přepis může využít strom projektu, aby lépe rozpoznal názvy funkcí nebo cest k souborům.

==== Správa sessions ====

Kimaki umí:

  * spustit novou session přes zprávu nebo ''/session'',
  * pokračovat ve starší session přes ''/resume'',
  * zastavit běžící session přes ''/abort'',
  * vytvořit veřejný odkaz na session přes ''/share'',
  * forknout session z konkrétní zprávy přes ''/fork'',
  * vrátit nebo zopakovat poslední změnu přes ''/undo'' a ''/redo''.

==== Fronta zpráv ====

Pokud agent ještě odpovídá, lze další instrukci zařadit do fronty přes ''/queue <message>''. Alternativně se dá zpráva ukončit textem ''. queue''. Kimaki ji odešle až po dokončení aktuální odpovědi.

==== Paměť projektu =====

Kimaki při startu session čte soubor ''MEMORY.md'' z kořene projektu. Agent ho může používat pro ukládání poznámek, rozhodnutí a kontextu, který má přežít mezi sessions.

==== Oprávnění nástrojů =====

Když se AI agent pokusí provést akci vyžadující schválení, například spustit shell příkaz nebo sáhnout mimo projekt, Kimaki zobrazí v Discord threadu tlačítka **Accept**, **Accept Always** a **Deny**. Výchozí chování se nastavuje v ''opencode.json'' podle [[https://opencode.ai/docs/permissions/|OpenCode Permissions dokumentace]].

===== Slash příkazy =====

README uvádí mimo jiné tyto příkazy:

  * ''/session <prompt>'' — spustí novou session s úvodním promptem,
  * ''/resume <session>'' — naváže na předchozí session,
  * ''/add-project <project>'' — vytvoří kanály pro existující OpenCode projekt,
  * ''/create-new-project <name>'' — vytvoří nový projektový adresář a session,
  * ''/new-worktree <name>'' — vytvoří git worktree a spustí session,
  * ''/merge-worktree'' — sloučí worktree branch do výchozí větve,
  * ''/model'' — změní AI model pro kanál nebo session,
  * ''/agent'' — změní agenta pro kanál nebo session,
  * ''/screenshare'' — nasdílí obrazovku přes VNC tunnel,
  * ''/upgrade-and-restart'' — aktualizuje Kimaki a restartuje bota.

Kimaki také registruje projektové slash příkazy z OpenCode: commands, skills a MCP prompts.

===== Přístupová práva =====

Kimaki před zpracováním zprávy kontroluje Discord oprávnění. Zprávy zpracuje jen od uživatelů, kteří mají některé z těchto oprávnění nebo rolí:

  * vlastník serveru,
  * oprávnění **Manage Server**,
  * oprávnění **Administrator**,
  * role **Kimaki**.

Roli **Kimaki** dokumentace doporučuje pro řízení týmového přístupu. Existuje také blokovací role **no-kimaki**, která má konkrétním uživatelům zabránit v používání bota.

===== Technické poznámky =====

Podle [[https://github.com/remorses/kimaki/blob/main/docs/internals.md|interní dokumentace Kimaki]] ukládá stav do SQLite databáze:

<code>
~/.kimaki/discord-sessions.db
</code>

Databáze mapuje Discord thready na OpenCode sessions, kanály na adresáře a ukládá také přihlašovací údaje bota.

Podle [[https://github.com/remorses/kimaki/blob/main/docs/advanced-setup.md|Advanced Setup dokumentace]] je Kimaki navržené jako „jeden bot na jeden stroj“. Bot může pracovat jen s adresáři na počítači, kde běží Kimaki CLI. Pro více počítačů je potřeba spustit samostatnou instanci Kimaki na každém z nich.

Metadata kanálu se ukládají do topicu Discord kanálu jako XML:

<code xml>
<kimaki><directory>/path/to/project</directory><app>bot_id</app></kimaki>
</code>

Při zprávě v kanálu Kimaki spustí nebo znovu použije OpenCode server pro daný adresář. Samotnou práci s kódem pak provádí OpenCode agent.

===== Kdy dává smysl =====

Kimaki dává smysl hlavně tam, kde je praktické ovládat coding agenta mimo terminál:

  * práce s agentem přes mobil nebo běžný Discord klient,
  * týmové zadávání a sledování agentních sessions,
  * oddělení projektů do kanálů a sessions do threadů,
  * dlouhé úlohy, kde se hodí queue, resume, fork a sdílené odkazy,
  * multi-agent scénáře, kde může Kimaki spouštět i jiný bot s rolí **Kimaki**.

Není to náhrada OpenCode. Kimaki je ovládací a integrační vrstva nad OpenCode, která přidává Discord jako rozhraní pro práci s lokálním coding agentem.

===== Zdroje =====

  * [[https://github.com/remorses/kimaki|Kimaki – GitHub repozitář]]
  * [[https://kimaki.dev|Kimaki – domovská stránka projektu]]
  * [[https://opencode.ai|OpenCode]]
  * [[https://discord.com/developers/applications|Discord Developer Portal]]
  * [[https://opencode.ai/docs/permissions/|OpenCode Permissions dokumentace]]
  * [[https://github.com/remorses/kimaki/blob/main/docs/internals.md|Kimaki – Internals]]
  * [[https://github.com/remorses/kimaki/blob/main/docs/advanced-setup.md|Kimaki – Advanced Setup]]