tw93/Kaku

Kaku – 内置 AI 助手的 macOS 终端

简介 – Kaku 是一款基于 WezTerm 引擎的预配置 macOS 终端。它自带实用的默认设置（JetBrains Mono 字体、深色/浅色主题、选中即复制、macOS 风格快捷键）和完整的基于 Lua 的配置层，同时增加了以 AI 为中心的辅助功能，如命令建议、自然语言转命令和集成聊天面板。

重要性 – 现代开发人员在 shell 中工作时越来越依赖 AI 助手（Claude、Gemini、Copilot 等）。Kaku 让这一工作流程变得顺畅：终端界面显示当前激活的 AI 代理，当 AI 生成的建议就绪时通知你，并允许你通过单个快捷键应用建议。它还支持通过浏览器远程访问 Mac 的终端，方便多设备使用。

主要功能

• 开箱即用的 UI – JetBrains Mono、自动主题切换、选中即复制、熟悉的 macOS 快捷键。
• 标签页和窗格 – 窗口拆分、标签导航、重启时恢复状态。
• 上下文菜单 – 右键操作：粘贴、搜索、AI 聊天、窗格/标签管理。
• 可点击链接 – Cmd+Click 直接打开 URL 或文件路径。
• AI 集成 – 活动代理指示器、Claude Code 通知、可选的命令建议助手、自然语言转命令（# 描述）以及完整聊天面板（Cmd+L）。
• 远程访问 – kaku remote 在另一台机器的浏览器中公开终端 UI。
• Shell 工具 – 内置 Zsh 补全、语法高亮、lazygit 和 Yazi 快捷键。
• Lua 配置 – 通过 ~/.config/kaku/kaku.lua 完全控制字体、主题、快捷键和终端行为。

开始使用

# 通过 DMG
brew install --cask kaku   # Homebrew cask
# 然后启动 Kaku，运行初始化向导
kaku init                    # 安装可选工具，设置 shell 集成
kaku --version               # 验证安装

首次启动后，右键菜单和 Cmd+Shift+A 快捷键即可访问 AI 面板。

AI 工作流程

• 命令建议 – 当命令失败时，配置的助手可以提议修复；按 Cmd+Shift+E 粘贴。
• 自然语言命令 – 输入 # <描述> 并回车；助手生成相应的 shell 命令。
• 聊天 – Cmd+L 打开与当前终端会话关联的聊天窗口；你可以讨论输出、请求文件相关操作，或通过 kaku chat 从另一个 shell 继续对话。
• 支持的服务 – Claude Code、Codex、Gemini CLI、Copilot CLI、Kimi Code 等（终端不托管任何模型；你需要自备 API 密钥。）

文档与支持 – 该项目托管网站（kaku.fun），提供功能对比、完整按键绑定参考、配置指南和 CLI 参考。欢迎提交 issue、PR，以及小规模赞助模式（通过作者的付费应用 Mole）。

许可证 – MIT（注明 WezTerm 和捆绑字体的归属）。

---

所有细节均直接取自仓库的 README。