📦 tw93/Kaku：为 AI 编程打造的极速开箱即用终端
英文标题：📦 tw93/Kaku
Kaku 是一款基于 WezTerm 深度定制、专为 AI 编程场景设计的 macOS 终端模拟器，主打零配置、40% 体积缩减与即时启动。它内置 AI 助手，支持错误自动修复和自然语言转命令，并深度集成 lazygit、yazi 等工具。该项目为开发者提供了高性能、高可定制性的终端新选择，采用 MIT 许可开源。
10.2 KB
732 B
565 B
553 B
594 B
553 B
460.5 KB
518.7 KB
857.5 KB
178.4 KB
中文
为 AI 编程而生的快速、开箱即用的终端。
Kaku（書く，かく）在日语中意为“书写”：将思想付诸形式的行为。它是 WezTerm 的一个深度定制分支，旨在提供开箱即用的实用默认配置，同时保留完整的 Lua 可定制性和快速轻量的体验。
Kaku 属于以下三部曲之一：Kaku（書く）编写代码，Waza（技）训练习惯，Kami（紙）交付文档。可以把它们想象成一个家庭：Kaku 是爸爸，Waza 是大姐，Kami 是小妹。
- 零配置：默认集成 JetBrains Mono 字体、macOS 字体渲染以及低分辨率字号。
- 主题感知体验：随 macOS 自动在深色与浅色模式间切换，并包含精细调整的选区颜色、字体粗细和实用的颜色覆盖支持。
- 精选 Shell 套件：内置 zsh 插件与可选的 CLI 工具，用于提示符、差异比较和导航工作流。
- 快速 & 轻量：二进制文件体积缩减 40%，即时启动，延迟加载，精简的 GPU 加速核心。
- 兼容 WezTerm 配置：可直接使用 WezTerm 的 Lua 配置，完全兼容 API，无需迁移。
- 打磨的默认设置：选中即复制、可点击的文件路径、从全屏应用窥视历史记录、窗格输入广播以及后台标签页完成时的可视响铃。
- 下载 Kaku DMG 并拖入应用程序文件夹
- 或通过 Homebrew 安装：
brew install tw93/tap/kakuku - 打开 Kaku。应用已通过 Apple 公证，打开时不会出现安全警告。
- 首次启动时，Kaku 将自动配置你的 Shell 环境。
| 操作 | 快捷键 |
|---|---|
| 新建标签页 | Cmd + T |
| 新建窗口 | Cmd + N |
| 关闭标签页/窗格 | Cmd + W |
| 切换标签页 | Cmd + Shift + [ / ] 或 Cmd + 1–9 |
| 切换窗格 | Cmd + Opt + 方向键 |
| 垂直拆分窗格 | Cmd + D |
| 水平拆分窗格 | Cmd + Shift + D |
| 打开设置面板 | Cmd + , |
| AI 面板 | Cmd + Shift + A |
| AI 聊天 | Cmd + L |
| 应用 AI 建议 | Cmd + Shift + E |
| 打开 Lazygit | Cmd + Shift + G |
| Yazi 文件管理器 | Cmd + Shift + Y 或 y |
| 清屏 | Cmd + K |
完整快捷键参考：docs/keybindings.md
Kaku 内置了 AI 编程辅助功能，包含两种模式和一个设置页面。
- 错误修复：当命令执行失败时，Kaku 会自动建议修复方案。按
Cmd + Shift + E即可应用。 - 自然语言转命令：在提示符处输入
# <描述>并按回车。Kaku 会将查询发送给大语言模型，并将生成的命令回填到提示符中，供你审查和执行。 - AI 工具配置：管理 Claude Code、Codex、Gemini CLI、Copilot CLI、Kimi Code 等工具的设置。
运行 kaku ai 可直接配置 AI 助手字段：
| 字段 | 用途 |
|---|---|
| 认证类型 | API 密钥或 Codex CLI 登录 |
| 简单模型 | 轻量级命令生成和快速聊天模型 |
| 深度模型 | 主要的 Cmd + L / k 聊天模型 |
| 基础 URL | OpenAI 兼容的 API 根地址，例如 https://api.openai.com/v1 |
| API 密钥 | 当认证类型为 API 密钥时，提供厂商的 API 密钥 |
完整 AI 助手文档：docs/features.md
| 指标 | 上游 | Kaku | 测试方法 |
|---|---|---|---|
| 可执行文件大小 | ~67 MB | ~40 MB | 激进的符号裁剪与特性精简 |
| 资源体积 | ~100 MB | ~80 MB | 资源优化与延迟加载 |
| 启动延迟 | 标准 | 即时 | 即时初始化 |
| Shell 引导时间 | ~200ms | ~100ms | 环境准备优化 |
有 Windows 或 Linux 版本吗？ 目前还没有。Kaku 现阶段仅支持 macOS。
我可以使用透明窗口吗？ 可以，在 ~/.config/kaku/kaku.lua 中设置 config.window_background_opacity。
kaku 命令丢失了。 运行 /Applications/Kaku.app/Contents/MacOS/kaku init --update-only && exec zsh -l，然后再执行 kaku doctor。
完整常见问题：docs/faq.md
- 快捷键 - 完整快捷键参考
- 功能特性 - AI 助手、lazygit、yazi、远程文件、Shell 套件
- 配置 - 主题、字体、自定义快捷键、Lua API
- CLI 参考 -
kaku ai、kaku config、kaku doctor等 - 常见问题 - 常见问题与故障排除
我在工作和个人项目中都重度依赖命令行。我构建过的工具，如 Mole 和 Pake，都反映了这一点。
我使用 Alacritty 多年，深知速度与简洁的价值。随着工作流转向 AI 辅助编程，我希望拥有更强大的标签页和窗格交互体验。我也探索过 Kitty、Ghostty、Warp 和 iTerm2。它们各有长处，但我仍然想要一个能够在性能、默认配置和控制力之间达到我所期望的平衡的终端。
WezTerm 健壮且高度可定制，我对其引擎和生态心怀感激。因此我构建了 Kaku 作为这样的环境：快速、精致、开箱即用。
衷心感谢所有为 Kaku 做出贡献的人。去关注他们吧！❤️
- 最直接支持我的方式是获取 Mole for Mac，这是我开发的付费 Mac 清理应用。
- 如果 Kaku 帮到了你，请为它点亮星标，分享它，或提交 issue 或 PR。
- 我有两只猫，汤圆和可乐。如果你觉得 Kaku 给你的生活带来了乐趣，可以给它们喂 罐头 🥩。
这些可爱的人已经这么做了 🐱
MIT 许可证，欢迎尽情使用并参与开源。
English / 原文
A fast, out-of-the-box terminal built for AI coding.
Kaku (書く, かく) is the Japanese word for writing: the act of putting thought into form. A deeply customized fork of WezTerm, built for practical defaults on day one while keeping full Lua customization and a fast, lightweight feel.
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.
- 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 |
| 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 has a built-in assistant with two modes and a settings page for AI coding tools.
- Error recovery : When a command fails, Kaku automatically suggests a fix. Press
Cmd + Shift + Eto apply. - Natural language to command : Type
# <description>at the prompt and press Enter. Kaku sends the query to the LLM and injects the resulting command back into the prompt, ready to review and run. - AI Tools Config : Manage settings for Claude Code, Codex, Gemini CLI, Copilot CLI, Kimi Code, and more.
Run kaku ai to configure the assistant fields directly:
| Field | Use |
|---|---|
| Auth Type | API key or Codex CLI login |
| Simple Model | Lightweight command generation and quick chat model |
| Deep Model | Primary Cmd + L / k chat model |
| Base URL | OpenAI-compatible API root, such as https://api.openai.com/v1 |
| API Key | Provider API key when Auth Type is API key |
Full AI assistant docs: docs/features.md
| 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 |
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.
Thekaku 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
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.
Big thanks to all contributors who helped build Kaku. Go follow them! ❤️
- The most direct way to support me is getting Mole for Mac, my paid Mac cleanup app.
- If Kaku helped you, give it a star, share it, or open an issue or PR.
- I have two cats, TangYuan and Coke. If you think Kaku delights your life, you can feed them canned food 🥩.
These lovely people already did 🐱
MIT License, feel free to enjoy and participate in open source.