tw93/Kaku
GitHub: tw93/Kaku
一款为 AI 编码优化的快速终端,基于 WezTerm 定制,提供零配置与即时启动体验。
Stars: 4195 | Forks: 218
Kaku
一款为 AI 编码而生的快速、开箱即用终端。
Kaku is a deeply customized fork of WezTerm, designed for an out-of-the-box experience.
## 功能特性
- **零配置**:默认使用 JetBrains Mono、macOS 字体渲染以及低分辨率字体缩放。
- **主题感知体验**:在 macOS 上自动在深色与浅色模式间切换,并优化了选中颜色、字体粗细以及对实用配色覆盖的支持。
- **精选 Shell 套件**:内置 zsh 插件与可选的 CLI 工具,支持提示符、差异对比与导航工作流。
- **快速轻量**:二进制体积缩小 40%,启动即时,支持惰性加载与精简的 GPU 加速核心。
- **WezTerm 兼容配置**:可直接使用 WezTerm 的 Lua 配置,保持完整的 API 兼容性且无需迁移。
- ** polished Defaults**:选中即复制、可点击的文件路径、从全屏应用预览历史记录、面板输入广播,以及后台标签页补全时的视觉提示铃。
## 快速开始
1. [下载 Kaku DMG](https://github.com/tw93/Kaku/releases/latest) 并拖拽到“应用程序”
2. 或通过 Homebrew 安装:`brew install tw93/tap/kakuku`
3. 打开 Kaku。该应用已由 Apple 公证,因此打开时不会出现安全警告
4. 首次启动时,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 + Shift + E` |
| 打开 Lazygit | `Cmd + Shift + G` |
| Yazi 文件管理器 | `Cmd + Shift + Y` 或 `y` |
| 清屏 | `Cmd + K` |
完整快捷键参考:[docs/keybindings.md](docs/keybindings.md)
## Kaku AI
Kaku 内置了一个支持两种模式的助手,并在 AI 编码工具页面提供统一设置。
- **错误恢复**:当命令执行失败时,Kaku 会自动建议修复方案。按下 `Cmd + Shift + E` 应用建议。
- **自然语言转命令**:在提示符中输入 `# <描述>` 并按下回车。Kaku 将查询发送至 LLM,并将返回的命令注入提示符,供你审查与执行。
- **AI 工具配置**:管理 Claude Code、Codex、Gemini CLI、Copilot CLI、Kimi Code 等工具的参数。
### 提供者预设
Kaku Assistant 支持内置提供者预设,便于快速配置。在 `kaku ai` 的下拉菜单中选择提供者,即可自动填充 API 基础 URL 与可用模型:
| 提供者 | 基础 URL | 模型 |
| :--- | :--- | :--- |
| OpenAI | `https://api.openai.com/v1` | (自由文本) |
| 自定义 | (手动) | (手动) |
当 Kaku Assistant 在命令出错后准备好建议时,按下 `Cmd + Shift + E` 应用建议。
完整 AI 助手文档:[docs/features.md](docs/features.md)
## 为何选择 Kaku?
我同时在工作和私人项目中高度依赖命令行工具。我所构建的工具,如 [Mole](https://github.com/tw93/mole) 和 [Pake](https://github.com/tw93/pake),正是这一理念的体现。
我曾长期使用 Alacritty,并深知速度与简洁的价值。随着工作流程转向 AI 辅助编码,我需要更强大的标签页与面板操作体验。我也探索过 Kitty、Ghostty、Warp 与 iTerm2。每款工具各有侧重,但我仍希望拥有一个在性能、默认配置与控制自由度之间取得平衡的环境。
WezTerm 稳定且高度可定制,我感激其引擎与生态。Kaku 在此基础上构建,为首日使用提供实用的默认配置,同时保留完整的基于 Lua 的自定义能力与轻快流畅的体验。
因此,我打造了 Kaku,使其成为:快速、精致、随时可用的编码环境。
### 性能
| 指标 | 上游 | Kaku | 方法论 |
| :--- | :--- | :--- | :--- |
| **可执行文件体积** | ~67 MB | ~40 MB | 激进的符号剥离与功能裁剪 |
| **资源占用** | ~100 MB | ~80 MB | 资源优化与惰性加载 |
| **启动延迟** | 标准 | 即时 | 即时初始化 |
| **Shell 启动** | ~200ms | ~100ms | 优化的环境预置 |
通过激进剥离未使用功能、惰性加载配色方案与 Shell 优化实现。
## 常见问题
**是否有 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`。
完整 FAQ:[docs/faq.md](docs/faq.md)
## 文档
- [快捷键](docs/keybindings.md) — 完整快捷键参考
- [功能特性](docs/features.md) — AI 助手、Lazygit、Yazi、远程文件与 Shell 套件
- [配置](docs/configuration.md) — 主题、字体、自定义快捷键与 Lua API
- [CLI 参考](docs/cli.md) — `kaku ai`、`kaku config`、`kaku doctor` 等
- [FAQ](docs/faq.md) — 常见问题与故障排除
## 支持
- 如果 Kaku 对你有帮助,[分享](https://twitter.com/intent/tweet?url=https://github.com/tw93/Kaku&text=Kaku%20-%20A%20fast%20terminal%20built%20for%20AI%20coding.) 给朋友或为项目点赞。
- 有想法或发现 Bug?提交 Issue 或 PR,欢迎贡献你最优秀的 AI 模型。
- 我有两只猫,糖糖和可乐。如果你觉得 Kaku 提升了你的体验,可以请它们喝杯咖啡 🥩。

## 许可证
MIT License,欢迎体验与参与开源。
标签:AI 编码, CLI 工具, GitHub Star, GPU 加速, JetBrains Mono, LangChain, MacOS, rizin, SEO, SOC Prime, WezTerm, zsh 插件, 主题感知, 定制终端, 开发工具, 开源, 快速启动, 技术分享, 浅色模式, 深色模式, 终端, 轻量级, 通知系统, 零配置