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