信息卡

一句话定位

用 Rust + GPUI（Zed 的 UI 框架）编写的原生桌面应用，把 Amp、Claude Code、Codex CLI、Cursor CLI、Kimi Code、OpenCode、Pi 等九种本地编码代理统一到一个项目与会话管理界面中，全程本地运行、无账号无远程服务。

走红原因分析

2026 年开发者平均同时装着好几个 agent CLI，切换会话靠翻终端历史。waku 抓住"多代理并存"这一真实痛点，靠 egoist 本人的社区影响力与"原生性能 + 完全本地隐私"卖点迅速起量：不造新代理而是做代理的驾驶舱，恰好填满了生态缝隙；GPUI 实现也让它看起来不像又一个 Electron 套壳。

核心功能拆解

• 统一多代理管理：自动探测本机已安装并认证过的 CLI，接入后共用一套项目/会话/转录视图。
• 共享控制面板：任意会话内统一切换模型、reasoning effort 与访问模式。
• 排队与转向：代理干活时继续排消息或中途调整方向，不必等它跑完。
• 对话感知回滚：基于 Git 的任务级 rewind checkpoint，可回到某轮对话之前的状态重试。
• 完全本地：应用状态全存本机 SQLite 与文件系统，无遥测依赖。

架构与技术栈浅析

桌面 App 是 RPC 客户端，真正的活儿由独立 `waku-daemon` 完成：provider 会话跑在 `waku-core` crate 内，经 `waku-protocol` 定义的带鉴权版本化 WebSocket 协议对外暴露；daemon 持有 SQLite 任务数据、附件、provider 原生会话分叉及全部文件/Git 操作。`apps/web` 下的浏览器客户端直接从 Rust 协议类型生成——协议变更需 `bun run protocol:generate && bun run protocol:check`。这种 client/daemon 分离为远程 daemon 预留了空间（当前默认仅 loopback）。

安装与环境要求

• macOS：从 waku.sh 下载签名 `.dmg`，支持自更新；
• Linux：`curl -fsSL https://waku.sh/install.sh | sh`，装入 `~/.local` 无需 root；
• Windows：GitHub Release 提供按用户安装的 Setup.exe 与便携 zip。

前提是至少安装并认证一个受支持的 agent CLI。源码开发要求 Rust 1.96+ 与 Bun：

bun install
bun run dev

Linux 支持 Wayland/X11，Windows 需 MSVC 工具链。

快速上手示例

安装后启动 waku，它会扫描可用 CLI 并列出各代理的项目与会话；选中即可在新窗口续聊或发起新任务。典型操作都在界面里完成：切模型、排入后续消息、查看 diff、用 checkpoint 回退。无项目场景的工作区落在 `~/.waku/projects//`，旧布局自动迁移。

进阶使用要点

• 配置分流：正式版桌面写 `~/.waku/app.json`，Debug 在 `temp/app.json`，daemon 设置在 `~/.waku/settings.json`。
• Settings → Daemon 可固定子 daemon 端口、白名单浏览器 origin 并共享 auth token，默认仅监听 loopback。
• 外部托管 daemon 时本地文件夹选择器与 PTY 暂不可用，其余能力均已走 RPC。
• 开发时用 `target/debug/waku-debug-daemon`，只改 provider 相关代码可热替换无需重启应用。
• 嵌入浏览器与实验性 computer-use 目前仅 macOS；会话/转录/skills/diff/编辑/终端三平台皆原生可用。

典型应用场景

• 多家 agent 并行开工时统一管理所有进行中的会话；
• 团队成员在 Claude Code/Codex/Kimi Code 之间自由比价选型；
• 借对话感知 checkpoint 安全试验激进改动；
• 隐私敏感环境下的纯本地代理驾驶舱。

同类生态位对比

对比 Claude Code/Codex 各自官方 GUI 的单一家园，waku 是跨代理聚合层；同赛道还Crystal、Conductor 等在争抢，但 waku 以 GPUI 原生渲染与 client/daemon 架构做出区分度。GPLv3 商用需留意传染性条款。

资源导航

• 官网下载：waku.sh
• 协议再生成：`bun run protocol:generate` / `protocol:check`
• 开发前置见 CONTRIBUTING.md；赞助走 GitHub Sponsors