Kaku README

The project's README from github.com/tw93/Kaku. As one markdown file: README.md.

Kaku

An AI-friendly Mac terminal with sensible defaults, ready out of the box.

Stars Version License Commits Twitter

Kaku Screenshot

Why

Kaku (書く, かく) means “to write” in Japanese. It is based on WezTerm, with fonts, themes, shell integration, and Mac shortcuts already configured. Lua settings remain available when you want to customize it.

Part of a trilogy: Kaku (書く) writes code, Waza (技) drills habits, Kami (紙) ships documents. Think of them as a family: Kaku is the dad, Waza the big sister, Kami the little sister.

Quick Start

Download the Kaku DMG, open it, and drag Kaku into Applications. Or install with Homebrew:

brew install tw93/tap/kakuku

Open Kaku to set up shell integration. Missing optional tools can be installed through kaku init.

Features

Usage Guide

Action Shortcut
New Tab Cmd + T
New Window Cmd + N
Close Tab/Pane Cmd + W
Navigate Tabs Cmd + Shift + [ / ] or Cmd + 1-9
Navigate Panes Cmd + Opt + Arrows
Split Pane Vertical Cmd + D
Split Pane Horizontal Cmd + Shift + D
Open Settings Panel Cmd + ,
AI Panel Cmd + Shift + A
AI Chat Cmd + L
Apply AI Suggestion Cmd + Shift + E
Open Lazygit Cmd + Shift + G
Yazi File Manager Cmd + Shift + Y or y
Clear Screen Cmd + K

Full keybinding reference: docs/keybindings.md

Kaku AI

Configure your own AI service with kaku ai to use the built-in assistant. Kaku does not provide or relay the AI service.

For authentication, models, API Mode, and tool settings, see the AI assistant docs.

FAQ

Is there a Windows or Linux version? Not currently. Kaku is macOS-only for now.

Can I use transparent windows? Yes, set config.window_background_opacity in ~/.config/kaku/kaku.lua.

The kaku command is missing. Run /Applications/Kaku.app/Contents/MacOS/kaku init --update-only && exec zsh -l, then kaku doctor.

Full FAQ: docs/faq.md

Docs

Background

I heavily rely on the CLI for both work and personal projects. Tools I've built, like Mole and Pake, reflect this.

I used Alacritty for years and learned to value speed and simplicity. As my workflow shifted toward AI-assisted coding, I wanted stronger tab and pane ergonomics. I also explored Kitty, Ghostty, Warp, and iTerm2. Each is strong in different areas, but I still wanted a setup that matched my own balance of performance, defaults, and control.

WezTerm is robust and highly hackable, and I am grateful for its engine and ecosystem. So I built Kaku to be that environment: fast, polished, and ready to work.

Contributors

Big thanks to all contributors who helped build Kaku. Go follow them! ❤️

Support

These lovely people already did 🐱

License

MIT License, feel free to enjoy and participate in open source. Attribution for WezTerm and the bundled fonts is in NOTICE.md.

Kaku (tw93/Kaku)

Searching Database…

6.1K ·GitHub
What is this?Kaku is a macOS terminal built on WezTerm that comes pre-configured with fonts, themes, shell integration, and Mac shortcuts, with an optional AI assistant for command suggestions and chat.
Is this a brand-new terminal engine or built on something existing?Kaku is not built from scratch — it's based on WezTerm, reusing its rendering engine and Lua configuration system, but shipping with sensible defaults already set up.
Do I need my own API key for the AI features?Yes — Kaku doesn't bundle or relay any AI service itself; you configure your own provider with the `kaku ai` command to power the built-in assistant.
Does it run on Windows or Linux too?No, Kaku is macOS-only for now, with no Windows or Linux version planned.
Who is this terminal aimed at?Developers who rely heavily on the CLI and want a fast, polished terminal tuned for AI-assisted coding workflows alongside tools like Lazygit and Yazi.
What coding agents does the AI panel work with?Kaku's AI Tools Config can manage settings for Claude Code, Codex, Gemini CLI, Copilot CLI, Kimi Code, and more, letting you use these agents alongside the built-in assistant.
What can the built-in AI assistant actually do?It can suggest fixes for failed commands (Cmd+Shift+E to apply), convert natural language typed after '#' into a shell command, and open a chat (Cmd+L) to discuss terminal output or project files.
What extra shell tools come built in?Kaku ships with zsh completion, syntax highlighting, and directory jumping out of the box, plus quick shortcuts to launch Lazygit and the Yazi file manager if installed.
Why did the author build Kaku instead of using iTerm2 or Warp?The author used Alacritty for years but wanted stronger tab/pane ergonomics for AI-assisted coding; after trying Kitty, Ghostty, Warp, and iTerm2, he built Kaku on WezTerm to match his own balance of speed, defaults, and control.
Creator
tw93
Size
40.8 MB
Stars
6.1K
Age
8mo
Commits · 90 Days