Kaku：开箱即用的 AI 原生终端

项目概述

Kaku是由twa（也是 Pake 的作者）开发的 AI 原生终端，核心定位是A fast, out-of-the-box terminal built for AI coding。Kaku 是WezTerm的深度定制分支，在保留 WezTerm 强大可配置性的同时，提供了开箱即用的极致体验。

官方定位：🎃 A fast, out-of-the-box terminal built for AI coding.

为什么需要 Kaku？

传统终端的痛点

作者在 README 中分享了他的心路历程：

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

他使用 Alacritty 多年，重视速度和简洁。随着 AI 辅助编程的工作流兴起，他需要更强的 tab 和 pane 操作手感。他尝试了 Kitty、Ghostty、Warp 和 iTerm2，每个在不同方面都很强，但仍然想要一个在性能、默认配置和控制权之间达到自己平衡的方案。

Kaku 的解决方案

Kaku 基于 WezTerm 构建，充分利用其强大的引擎和生态系统，同时提供实用的开箱即用配置，保持完整的 Lua 可定制性和轻盈快速的体验。

设计理念：

• 开箱即用：安装后立即投入使用，无需复杂配置
• 性能优先：40%更小的体积，即时启动
• AI 原生：内置 AI 助手，支持多种 AI 编码工具

核心特性

🎯 Zero Config 开箱即用

Kaku 预设了精心调配的默认配置，让用户安装后立即拥有最佳体验：

默认配置包括：
├── JetBrains Mono 字体
├── macOS 原生字体渲染
└── 低分辨率字体优化

🌓 Theme-Aware 自适应主题

Kaku 能跟随 macOS 系统主题自动切换深色/浅色模式，并对以下细节进行优化：

🐚 Curated Shell Suite 精选 Shell 套件

内置精选的 zsh 插件和可选 CLI 工具，覆盖以下场景：

• Prompt 优化：美化终端提示符
• Diff 工作流：便捷的差异对比
• 导航增强：快速目录切换

⚡ Fast & Lightweight 极致性能

性能对比表：

🔧 WezTerm 兼容配置

Kaku完全兼容 WezTerm 的 Lua 配置：

-- Kaku可以直接使用WezTerm的Lua配置
local wezterm = require 'wezterm'

return {
  -- 任何WezTerm配置在Kaku中都能工作
  font = wezterm.font 'JetBrains Mono',
  color_scheme = 'nord',
}

这意味着：

• ✅ 无需迁移现有 WezTerm 配置
• ✅ 完整的 WezTerm Lua API 兼容性
• ✅ 社区所有 WezTerm 配置拿来即用

✨ Polished Defaults 精心打磨的细节

Kaku 预设了大量实用功能：

AI 集成：Kaku AI

内置 AI 助手

Kaku 内置 AI 助手，支持两种模式：

1. Error Recovery 错误自动恢复

当命令执行失败时，Kaku 会自动分析错误并建议修复方案：

# 执行失败的命令
$ npm run build
> error: Cannot find module 'express'

# Kaku自动检测并提示：
# 💡 建议: npm install express
# 按 Cmd+Shift+E 应用建议

使用方式：按 Cmd+Shift+E 应用 AI 建议

2. Natural Language to Command 自然语言转命令

在提示符输入 # <描述>，Kaku 会将自然语言查询发送给 LLM，并把生成的命令注入回提示符：

# 输入自然语言
# 查找最近修改的TypeScript文件并显示内容

# Kaku转换为：
$ find . -name "*.ts" -mtime -7 | xargs cat

支持的 AI Provider

Kaku 支持多种 AI 服务提供商：

推荐配置：

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.

AI 快捷键

快速上手

安装

方式一：下载 DMG（推荐）

1. 下载最新 DMG：Kaku DMG下载
2. 拖拽到 Applications 文件夹
3. 首次打开会提示安全警告（已签名，无需担心）

方式二：Homebrew

brew install tw93/tap/kakuku

初始化

首次启动时，Kaku 会自动配置 shell 环境：

1. 打开Kaku
2. Kaku会自动检测并配置shell
3. 开始使用！

快捷键参考

基础操作

分屏操作

AI 操作

工具集成

与同类终端对比

Kaku 的独特优势

1. 开箱即用的 AI 集成：无需配置，直接使用
2. WezTerm 兼容：社区配置拿来即用
3. 性能与功能的平衡：比 WezTerm 更轻，但保留了所有核心功能
4. 精心打磨的默认体验：Copy on Select、可点击路径等细节开箱即有

技术架构

架构分层

┌─────────────────────────────────────────────┐
│              Kaku UI Layer                  │
│         (基于WezTerm前端)                  │
├─────────────────────────────────────────────┤
│           Kaku AI Engine                   │
│    (内置AI助手 + Provider配置)              │
├─────────────────────────────────────────────┤
│         WezTerm Core Engine               │
│     (Rust GPU加速渲染 + Lua配置)           │
├─────────────────────────────────────────────┤
│          System Integration               │
│    (macOS原生 + Shell环境)                │
└─────────────────────────────────────────────┘

目录结构

Kaku/
├── kaku/              # 核心引擎
├── kaku-gui/          # GUI组件
├── term/              # 终端渲染
├── termwiz/           # 终端后端
├── mux/               # 多路复用器
├── window/            # 窗口管理
├── lua-api-crates/    # Lua API
├── config/            # 配置
├── docs/              # 文档
└── assets/           # 资源文件

配置指南

配置文件位置

~/.config/kaku/kaku.lua

基础配置示例

local wezterm = require 'wezterm'

return {
  -- 字体
  font = wezterm.font 'JetBrains Mono',
  font_size = 12.0,
  
  -- 窗口透明背景
  window_background_opacity = 0.9,
  
  -- 分屏快捷键重映射
  keys = {
    {
      key = 'd',
      mods = 'CMD',
      action = wezterm.action.SplitHorizontal { domain = 'CurrentPaneDomain' },
    },
  },
  
  -- AI Provider配置
  kaku_ai_provider = 'minimax',
  kaku_ai_api_key = 'your-api-key',
}

AI Provider 配置

-- 配置OpenAI
config.kaku_ai_provider = 'openai'
config.kaku_ai_api_key = 'sk-...'

-- 或配置MiniMax
config.kaku_ai_provider = 'minimax'
config.kaku_ai_api_key = '...'

-- 自定义Provider
config.kaku_ai_provider = 'custom'
config.kaku_ai_base_url = 'https://api.example.com/v1'

常见问题 FAQ

Q: Kaku 和 WezTerm 什么关系？

A: Kaku 是 WezTerm 的深度定制分支。它：

• 基于 WezTerm 核心引擎
• 使用相同的 Lua 配置格式
• 完全兼容 WezTerm 配置
• 增加了 AI 集成和开箱即用优化
• 体积比 WezTerm 小 40%

Q: Kaku 支持 Windows 或 Linux 吗？

A: 目前仅支持 macOS。Windows 和 Linux 版本正在规划中。

Q: 如何使用透明窗口？

A: 在 ~/.config/kaku/kaku.lua 中设置：

config.window_background_opacity = 0.85  -- 85%透明度

Q: 为什么启动比普通终端快？

A: Kaku 通过以下方式实现即时启动：

1. JIT 初始化：仅在需要时加载组件
2. 懒加载颜色方案：按需加载
3. 优化 Shell 准备：减少 Shell 启动时间

Q: 内置的 AI 需要付费吗？

A: AI 功能本身免费，但需要自备 AI Provider 的 API Key（如 OpenAI、MiniMax 等）。

Q: 可以禁用 AI 功能吗？

A: 可以。Kaku 的 AI 功能完全可选，不需要可以完全不使用。

使用场景

适用场景

不适用场景

总结

Kaku 在开箱即用的便捷性和 WezTerm 强大的可配置性之间找到了一个平衡点。

核心优势：

1. AI 原生：内置 AI 助手，支持错误恢复和自然语言转命令
2. 极致性能：比上游小 40%，即时启动
3. 零配置：安装即用，无需调优
4. WezTerm 兼容：社区配置拿来即用

推荐人群：

• ✅ macOS 用户
• ✅ 追求 AI 辅助编程体验
• ✅ 想要开箱即用的终端
• ✅ WezTerm 用户（不想折腾配置）

项目地址：https://github.com/tw93/Kaku

本文基于 Kaku V0.9.0 版本编写，发布时间：2026-04-07