Alethe

多智能体编程工作区。
在同一款本地优先的桌面应用里，并排运行 Claude Code、Codex、Copilot 以及你的 Shell。
English

Important

Alethe 目前仍是早期公开发布版本。桌面应用免费、开源，并且是本地优先（local-first），但并非完全离线：默认会进行更新检查与提供商用量轮询；其他网络功能多为可选，或由用户操作触发。手动的 GitHub Gist Sync 已经可用；官方托管同步或云备份可能会在之后单独提供。详见隐私与数据流说明。

本文为社区中文说明，内容对应英文 README.md。若中英文不一致，以英文版为准。

Alethe 是什么

单个终端里跑一个智能体很容易。真正难的是：三个仓库、五个智能体同时干活——这时普通终端标签页就不够用了：会话容易丢、MCP 服务在智能体之间不同步，也没人清楚「谁在做什么、在哪里做」。

Alethe 就是为这种情况打造的桌面工作区。 每个智能体都在真实的 PTY 里运行，嵌在持久化的项目布局中，各自保留会话与历史；你调整界面时它们也不会因此中断。在此之上，Alethe 还统一管理智能体共享的部分：CLI、MCP 服务器、Skills，以及你在智能体之间流转的对话。

跨平台（Windows、macOS、Linux），本地优先，基于 Tauri、Rust、React 与 xterm.js 构建。「本地优先」描述的是工作区持久化方式，并不保证完全无网络；当前的网络默认行为、凭据与保留策略见 docs/PRIVACY.md。

支持的平台

macOS	Windows	Linux

支持 macOS	支持 Windows	支持 Linux

智能体

智能体	CLI
Claude Code	`claude`	会话恢复、用量卡片、本地历史
Codex	`codex`	会话恢复、用量卡片
GitHub Copilot CLI	`copilot`
Cursor	`cursor-agent`	会话恢复
Antigravity	`agy`	用量卡片
OpenCode	`opencode`	会话恢复
Kiro CLI	`kiro-cli`
Mimo	`mimo`
Freebuff	`freebuff`
Shell	pwsh / bash / zsh	普通终端，同一套窗格模型
WSL	`wsl.exe`	默认发行版，作为普通 Shell（Windows）

缺失的 CLI 可以在 Alethe 内安装、更新与卸载——它会探测本机的 Node、npm、WinGet、Scoop、Chocolatey，只提供真正可用的方式，并优先使用各厂商官方安装器。已安装的 CLI 会从 PATH、注册表、npm/pnpm/Volta/fnm/nvm/Bun/Cargo/Scoop/Chocolatey 等位置发现，也可手动指定自定义路径。插件还可以向此列表添加自有智能体。

智能体可选择经 9router 路由——这是一个本地代理，可在多个提供商之间分发流量并自动回退。Alethe 会安装并运行一份私有、版本锁定的副本，不会改动你的全局 npm 包。路由默认关闭，且仅对开启后新打开的终端生效。

它能做什么

并行运行智能体

用项目、分组与子分组组织仓库；每个打开的项目成为一个容器，拥有自己的窗格。
每个窗格一个智能体，或在同一窗格里用子标签页放多个智能体——各自独立的 PTY、工作目录与会话。
自动、聚焦、侧边栏与自定义网格布局，可直接在网格上编辑。
关闭容器只会隐藏界面；进程继续运行。

保留上下文

Claude Code、Codex、Cursor 与 OpenCode 的会话可在崩溃或重启后恢复。
最近对话 列出某窗格工作目录下的会话，并可重新打开其中任意一条。
Claude Code 的对话可通过本地脱敏的上下文包 交接给 Codex（也可反向），无需手工复制整段线程。脱敏是尽力而为，启动目标智能体前请先检查上下文包。
每个 PTY 都会持久化回滚缓冲，重新附着时能看到之前发生了什么。

管理智能体共享的内容

MCP 标签页：本机配置的全部 MCP 服务器，按服务器分组，并显示哪些智能体在用——读取 Claude Code、Codex、Cursor、OpenCode 与 Antigravity 的配置。可添加、移除、在智能体之间复制服务器，搜索官方注册表，并让各智能体验证是否真正连得上。每次写入都会备份、重新解析并以原子方式提交。
Skills 标签页：各智能体已安装的 skills，解析链接与共享存储，使共享 skill 只显示一次。
Graphify：项目的代码图谱，作为 MCP 服务器提供给智能体。

用插件扩展

功能以插件形式加载，而不是写死在代码里。官方插件——待办列表、Git 控制、主题包——随安装包分发，可在「偏好设置 ▸ 插件」中关闭；对应界面会随之出现或消失，无需重启。
插件可贡献工作区窗格、侧边栏标签、命令面板条目、完整主题，或新的智能体提供商。它在清单中声明所需能力，应用会拒绝未声明的请求。
插件目录：其他人发布的插件会在 Alethe 内列出并写明权限；带安装包的条目可一键安装与更新。目录会为每个包固定 SHA-256 校验和，确保运行内容与审阅时一致。已安装插件默认关闭，启用前会经过信任对话框。

发布插件

插件是一个文件夹，名称与其 plugin.json 中的 id 一致，旁边是绑定 window.alethe 的 main.js 打包文件（React 已内置——不要自行打包 React）。清单声明标签页、命令与能力；代码负责实现。

本地试用。 把文件夹放到 <profile>/plugins/<id>/，或使用「偏好设置 ▸ 插件 ▸ 导入插件」。导入后默认关闭——启用以信任对话框为准。
打包 zip。 压缩插件文件夹，计算 SHA-256，并挂到发布页：
zip -r my-plugin.zip my-plugin && sha256sum my-plugin.zip。
申请上架。 向本仓库提交 PR，在 plugins.json 增加一条，包含 id、name、downloadUrl，以及为了可从 Alethe 内安装所需的 package.url 与 package.sha256。zip 变更后请重新计算哈希。
合并后，列表会在六小时内同步到所有人，或在点击刷新后立即更新。

上架是人工阅读你的 PR，不是安全审计：插件仍会以禁用状态到达，仍需信任对话框。docs/examples/notes-plugin/ 是一个无需构建步骤的纯 JavaScript 示例；完整约定见插件指南。

保持掌控

标题栏显示内存占用；可禁用终端或挂起整个分组以释放内存。
每个项目的 Git 面板——状态、暂存、提交、分支、在窗格中查看 diff——以及用于并行任务的 worktree。
Pull Request 审阅：合并面板通过本地 gh CLI 查找智能体 worktree 对应的 GitHub PR，打开其元数据，并可在同一隔离 worktree 中启动 AI 审阅——只读，不会提交、推送、合并或发表 GitHub 评论。Squash 合并仍需明确的人为操作；若 head SHA 已变、PR 为草稿，或 GitHub 报告冲突，则会阻止。不存储 GitHub token；身份验证交给 gh。
终端旁的内容窗格：文件浏览器、Markdown、diff、图片、视频、内嵌浏览器。
每项目待办与番茄钟、隔离配置档、本地备份导出/导入、界面与终端主题，支持 EN、pt-BR 与 zh-CN。
编排看板：一个主智能体把工作单元委派给 Claude 与 Codex 工作器，由 Alethe 并行运行——可选各自独立的 git worktree，卡片上汇报状态、费用、token 与 diff，离开沙箱前也可先征求你的同意。默认关闭。
本地语音听写（设备端模型）与通过 GitHub 登录的 偏好云同步——均为可选。
远程控制：经认证的局域网 Web 视图，通过二维码配对，可在手机上跟进并回复智能体。默认关闭，在局域网上使用未加密的 HTTP/WebSocket，因此请仅在可信网络启用。干净配置档默认为只读；回复智能体需要单独开启输入权限，Shell 输入还有额外开关。
Spotify 正在播放：在 偏好设置 ▸ Spotify 中填入你自己的 Spotify 应用凭据，回调 URI 为 http://127.0.0.1:8888/callback。当前版本会把这些凭据存在本地配置档中；导出或分享配置档前请阅读隐私说明。

核心概念


分组（Group）	一组可一起打开、折叠与挂起的项目。
项目（Project）	已保存的工作上下文：终端、布局、颜色、本地状态。
容器（Container）	已打开项目的可见框架。关闭它不会结束任何进程。
窗格（Pane）	容器内的一个终端视图。
子标签（Sub-tab）	同一窗格内的另一个智能体或 Shell 会话。
PTY	真实后端进程，独立于 UI 存活。

产品理念

聚焦核心、能力可选，更接近 Obsidian，而不是功能堆满的 IDE。非必要功能放在功能开关或可选设置之后，干净安装也应是一等体验。一致性优于堆量。

安装

请从 Releases 使用已发布的安装包。

Warning

Windows 构建尚未代码签名，因此 Defender 可能把 alethe.exe 标为 Trojan:Win32/Bearfoos.A!ml 并隔离。!ml 后缀表示机器学习启发式，而非发布者签名；像派生子进程、创建 PTY 这类终端复用行为也可能触发误报。请确认下载来自官方 Releases 页面；不要对其他来源的文件绕过警告。

恢复方式：Windows 安全中心 → 病毒和威胁防护 → 保护历史记录 → 操作 → 还原，然后为 %LOCALAPPDATA%\Alethe 添加排除项（若从源码构建，也可排除 src-tauri/target）。误报可向 Microsoft Security Intelligence 提交。macOS 构建也尚未公证——请右键应用并选择打开以绕过 Gatekeeper。签名与公证已在路线图中。

从源码运行

git clone https://github.com/Kc1t/alethe-agents.git
cd alethe-agents
npm install
npm run app

要求：Node.js 18+、稳定版 Rust、Windows 上的 Visual Studio Build Tools，以及 Linux 上的 Tauri 系统依赖：

sudo apt install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf

npm run app          # 带热重载的桌面应用
npm run dev          # 仅前端
npm run build        # 类型检查 + 构建前端
npm run tauri build  # 安装包 → src-tauri/target/release/bundle/

终端命令

在 设置 ▸ 集成 ▸ 终端命令 中安装 alethe 命令：

alethe                # 将当前文件夹作为项目打开
alethe ~/some/project # 打开指定文件夹

若该文件夹已是项目，会把它带入工作区而不是重复创建。若 Alethe 已在运行，会聚焦现有窗口。命令安装到 ~/.local/bin/alethe（macOS/Linux）或 %LOCALAPPDATA%\Alethe\bin\alethe.cmd（Windows）——移动应用后请重新安装。

路线图

多智能体工作区：项目、分组、容器与子标签。
真实 PTY：启动、附着、调整大小、回滚缓冲与会话恢复。
智能体安装/更新/卸载，以及 MCP 与 skills 管理。
Windows、Linux、macOS 发布包。
Windows 发布签名与 macOS 公证。
在真实机器上更广泛地验证 Linux/macOS。
官方托管云同步/备份（手动 GitHub Gist Sync 已可用）。

参与贡献 {#contributing}

欢迎贡献。请阅读 CONTRIBUTING.md 了解环境搭建、项目结构与约定。最容易上手的方式：

认领带 good first issue 或 help wanted 标签的议题——先留言声明。
用清晰复现步骤报告 bug，或说明能改进的工作流来提功能建议。
改进文档、截图与平台验证——Linux 与 macOS 测试最少。

较大改动请先开 issue 讨论方向。

用 Alethe 构建的作品

以下是以 Alethe 为工作区构建的项目与产品——智能体并行运行、Shell 并肩协作、会话跨天恢复。

暂无条目。 用 Alethe 做出了什么？把它加到 SHOWCASE.md——只需一行和一个 PR，你也会进入贡献者列表。

完整列表与提交方式见 SHOWCASE.md。

观看 Alethe 实战

看看 Alethe 在真实开发流程中的用法，学习如何并行编排编程智能体。

视频	你将看到
	Stop Using One AI Agent at a Time: Orchestrate AI Agents 实用介绍：如何协调多个 AI 编程智能体，而不是一次只用一个。 _{Kauã Miguel - Dev · 葡萄牙语}
	A Day in the Life of a Software Developer — Devlog 1 真实开发者工作流，展示 Alethe 如何融入日常编码。 _{Guilherme Dev · 葡萄牙语}