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:
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:
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í:
/session,/resume,/abort,/share,/fork,/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í:
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:
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.