Kimaki

Vytvořeno: 16.5.2026 | Aktualizováno: 16.05.2026 17:14

Kimaki je Discord bot a CLI nástroj pro ovládání 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 kimaki.dev.

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.

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

npx -y kimaki@latest

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

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.

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.

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.

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.

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 OpenCode Permissions dokumentace.

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.

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.

Podle interní dokumentace Kimaki ukládá stav do SQLite databáze:

~/.kimaki/discord-sessions.db

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

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

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

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.

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.