Skip to content
Kaku

CLI Commands

CLI Reference

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.

Terminal window
kaku ai

kaku config

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

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

Terminal window
kaku doctor

kaku update

Check for and install the latest Kaku release.

Terminal window
kaku update

kaku reset

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

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

Terminal window
kaku init

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

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

kaku cli

Interact with the Kaku multiplexer from scripts and external tools.

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