Docs

CLI 参考

从 shell 打开 AI 设置、聊天、配置、诊断、更新和 multiplexer 命令。

Run kaku in your terminal to see all available commands.

#kaku ai

Open the AI settings panel inside Kaku. Configure external coding tools (Claude Code, Codex, Gemini CLI, Copilot CLI, Kimi Code, etc.) and Kaku Assistant.

kaku ai

#kaku chat

Start Kaku's standalone AI chat from any shell. This is a discoverable alias for the bundled k helper, so it works even when k is not on your PATH.

kaku chat                 # open interactive chat
kaku chat "explain this"  # one-shot prompt

The chat uses ~/.config/kaku/assistant.toml, shares the same conversation and memory files as the Cmd + L overlay, and supports /new, /resume, /clear, /status, /memory, and /exit in interactive mode.

#kaku config

Open the Kaku configuration file (~/.config/kaku/kaku.lua) in your default editor. Also accessible from the settings panel with Cmd + ,.

kaku config

#kaku doctor

Run diagnostics and verify that Kaku's shell integration, PATH entries, and optional tool installations are healthy. Use this first if something feels broken.

kaku doctor

#kaku update

Check for and install the latest Kaku release.

kaku update

#kaku reset

Reset Kaku's config and state files to defaults. Use with caution, this overwrites ~/.config/kaku/kaku.lua.

kaku reset

#kaku init

Set up Kaku's shell integration for zsh and/or fish. Creates ~/.config/kaku/zsh/kaku.zsh and optionally ~/.config/kaku/fish/kaku.fish. Also installs optional CLI tools (Starship, Delta, Lazygit, Yazi) via Homebrew.

kaku init

If the kaku command goes missing from your shell, restore it with:

/Applications/Kaku.app/Contents/MacOS/kaku init --update-only
exec zsh -l

#kaku cli

Interact with the Kaku multiplexer from scripts and external tools.

kaku cli split-pane                          # split current pane
kaku cli split-pane -- bash -c "echo hello"  # split and run a command
kaku cli --help                              # list all subcommands
kaku cli split-pane --help                   # help for a specific subcommand

Useful for integrating Kaku with AI tools or shell scripts that need to open panes or tabs programmatically.