Docs

Install

Add Kaku to your macOS workflow with the DMG, Homebrew, or a local source build.

#Download DMG

Most users should download the latest DMG from GitHub Releases. Open the image, drag Kaku into Applications, then launch it from the app list.

Open latest Release

#Homebrew

If you already manage developer tools with Homebrew, install Kaku from the tap.

brew install tw93/tap/kakuku
open -a Kaku
kaku doctor

Homebrew fits machines that need command-line installation and scripted updates. The package is tw93/tap/kakuku, not the older unrelated kaku package on Homebrew.

#Source build

Source builds are mainly for contributors. You need Rust, a local macOS build setup, and the repository build scripts.

git clone https://github.com/tw93/Kaku.git
cd Kaku
make app

#After install

Open Kaku once after installation, then run kaku doctor. It checks the app bundle, config directory, PATH, zsh/fish shell integration, and optional tools.

/Applications/Kaku.app/Contents/MacOS/kaku doctor

If your shell cannot find kaku, restore shell integration with the bundled binary, then restart your login shell:

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

#Troubleshooting

  • Confirm the app lives at /Applications/Kaku.app. Do not run it directly from the DMG.
  • If Homebrew install fails, confirm you are using brew install tw93/tap/kakuku. If kaku update reports checksum issues, run brew upgrade tw93/tap/kakuku directly.
  • For first-time shell tooling, run kaku init. It provisions zsh/fish integration and can install Starship, Delta, Lazygit, and Yazi through Homebrew.
  • If AI features do not work, open kaku ai and check provider, base URL, Simple Model, Deep Model, and API key.
  • When filing an issue, include install method, macOS version, Kaku version, and reproduction steps.

Open GitHub Issues