Kaku is a deeply customized fork of WezTerm, designed for an out-of-the-box experience.
- Zero Config: Defaults with JetBrains Mono, macOS font rendering, and low-res font sizing.
- Theme-Aware Experience: Auto-switches between dark and light modes with macOS, with tuned selection colors, font weight, and practical color overrides support.
- Curated Shell Suite: Built-in zsh plugins with optional CLI tools for prompt, diff, and navigation workflows.
- Fast & Lightweight: 40% smaller binary, instant startup, lazy loading, stripped-down GPU-accelerated core.
- WezTerm-Compatible Config: Use WezTerm's Lua config directly with full API compatibility and no migration.
- Polished Defaults: Copy on select, clickable file paths, history peek from full-screen apps, pane input broadcast, and visual bell on background tab completion.
- Download Kaku DMG & Drag to Applications
- Or install with Homebrew:
brew install tw93/tap/kakuku - Open Kaku. The app is notarized by Apple, so it opens without security warnings
- On first launch, Kaku will automatically set up your shell environment
| 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 |
| 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 includes a built-in assistant for command-line error recovery and a single AI settings page for coding tools.
- Kaku Assistant: Automatically analyzes failed commands and suggests a safe fix. Press
Cmd + Shift + Eto apply. Enable or disable it fromkaku ai. - AI Tools Config: Manage settings for Claude Code, Codex, Gemini CLI, Copilot CLI, Kimi Code, and more.
Tip: DeepSeek-V3.2 via VivGrid is a great low-cost option to start with for everyday AI coding tasks.
Kaku Assistant supports built-in provider presets for quick setup. Select a provider from the dropdown in kaku ai to auto-fill the API base URL and available models:
| Provider | Base URL | Models |
|---|---|---|
| VivGrid (default) | https://api.vivgrid.com/v1 |
DeepSeek-V3.2 |
| MiniMax | https://api.minimax.io/v1 |
MiniMax-M2.7, M2.7-highspeed, M2.5, M2.5-highspeed |
| OpenAI | https://api.openai.com/v1 |
(auto-detected) |
| Custom | (manual) | (manual) |
To use MiniMax, select "MiniMax" as the provider, enter your API key from MiniMax Platform, and choose a model. MiniMax-M2.7 (1M context) is recommended for everyday AI coding tasks.
When Kaku Assistant has a suggestion ready after a command error, press Cmd + Shift + E to apply it.
Full AI assistant docs: docs/features.md
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. Kaku builds on that foundation with practical defaults for day one use, while keeping full Lua-based customization and a fast, lightweight feel.
So I built Kaku to be that environment: fast, polished, and ready to work.
| Metric | Upstream | Kaku | Methodology |
|---|---|---|---|
| Executable Size | ~67 MB | ~40 MB | Aggressive symbol stripping & feature pruning |
| Resources Volume | ~100 MB | ~80 MB | Asset optimization & lazy-loaded assets |
| Launch Latency | Standard | Instant | Just-in-time initialization |
| Shell Bootstrap | ~200ms | ~100ms | Optimized environment provisioning |
Achieved through aggressive stripping of unused features, lazy loading of color schemes, and shell optimizations.
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
- Keybindings — full shortcut reference
- Features — AI assistant, lazygit, yazi, remote files, shell suite
- Configuration — themes, fonts, custom keybindings, Lua API
- CLI Reference —
kaku ai,kaku config,kaku doctor, and more - FAQ — common questions and troubleshooting
Big thanks to all contributors who helped build Kaku. Go follow them! ❤️
- If Kaku helped you, star the repo or share it with friends.
- Got ideas or found bugs? Open an issue/PR or check CONTRIBUTING.md for details.
- Like Kaku? Buy Tw93 a Coke to support the project! 🥤 Supporters below.
MIT License, feel free to enjoy and participate in open source.