EnsoAI

多路智能，并行穿梭

让多路 AI 助手化身并行线程，在同一个项目的不同分支间自由穿梭。

Claude、Gemini 与 Codex 同步协作，思路永不中断。

中文 | English

---

重构你的工作流

告别 git stash。EnsoAI 将每个分支视为一等公民，赋予其独立的工作区与 AI 上下文。

---

安装

包管理器（推荐）

macOS (Homebrew)

brew tap j3n5en/ensoai
brew install --cask ensoai

Windows (Scoop)

scoop bucket add ensoai https://github.com/J3n5en/scoop-ensoai
scoop install ensoai

Windows (Winget)

winget install J3n5en.EnsoAI

手动下载

从 GitHub Releases 下载适合你平台的安装包：

平台	文件
macOS (Apple Silicon)	EnsoAI-x.x.x-arm64.dmg
macOS (Intel)	EnsoAI-x.x.x.dmg
Windows (安装版)	EnsoAI-Setup-x.x.x.exe
Windows (便携版)	EnsoAI-x.x.x-portable.exe
Linux (AppImage)	EnsoAI-x.x.x.AppImage
Linux (deb)	ensoai_x.x.x_amd64.deb

从源码构建

# 克隆仓库
git clone https://github.com/J3n5en/EnsoAI.git
cd EnsoAI

# 安装依赖（需要 Node.js 20+、pnpm 10+）
pnpm install

# 开发模式运行
pnpm dev

# 生产构建
pnpm build:mac    # macOS
pnpm build:win    # Windows
pnpm build:linux  # Linux

---

功能特性

多 Agent 矩阵

无缝切换 Claude、Codex、Gemini 或本地 LLM。每个 Worktree 都有独立的持久化 AI 会话。

内置支持： - Claude - Anthropic 的 AI 助手，支持会话持久化 - Codex - OpenAI 的编程助手 - Gemini - Google 的 AI 助手 - Cursor - Cursor 的 AI 助手 (cursor-agent) - Droid - Factory CLI，AI 驱动的 CI/CD 助手 - Auggie - Augment Code 的 AI 助手

你也可以通过指定 CLI 命令来添加自定义 Agent。

---

内置 Git 管理器

优雅的可视化 Git 面板。通过键盘即可完成差异对比、暂存修改和提交代码。

• 变更列表显示所有修改的文件
• 支持暂存/取消暂存操作
• 提交历史浏览
• 代码差异对比视图

---

内置代码编辑器

基于 Monaco 构建的轻量级编辑器。支持 50+ 种语言高亮，提供流畅的多标签拖拽体验。

• 多标签编辑，支持拖拽排序
• 文件树支持创建/重命名/删除操作
• 自动语言检测
• 编辑器状态跨会话持久化

---

AI 代码审查

自动生成高质量的 Commit Message，并利用 AI 助手对代码变更进行深度审查与优化。

---

三栏合并工具

内置专业的三栏合并编辑器。清晰展示冲突来源，支持一键采纳变更与实时结果预览，让解决冲突变得轻松愉悦。

---

Worktree 管理

毫秒级创建与切换 Git Worktree。在不同功能分支间自由穿梭，无需重复配置环境。

• 从现有分支或新分支创建 worktree
• 即时切换 worktree
• 删除 worktree 并可选择同时删除分支
• 可视化 worktree 列表，显示分支状态

---

IDE 桥接

在 EnsoAI 中统筹全局，一键跳转至 VS Code 或 Cursor 进行深度开发。无缝衔接现有工具链。

通过 Cmd+Shift+P 打开命令面板： - 面板控制 - 切换 Workspace/Worktree 侧边栏显示 - 设置 - 打开设置对话框 (Cmd+,) - 打开方式 - 在 Cursor、Ghostty、VS Code 等中打开当前项目

---

其他特性

• 多窗口支持 - 同时打开多个工作空间
• 主题同步 - 应用主题可与终端主题（400+ Ghostty 主题）同步
• 键盘快捷键 - 高效导航（Cmd+1-9 切换标签）
• 设置持久化 - 所有设置保存为 JSON，便于恢复

---

技术栈

• 框架: Electron + React 19 + TypeScript
• 样式: Tailwind CSS 4
• 编辑器: Monaco Editor
• 终端: xterm.js + node-pty
• Git: simple-git
• 数据库: sqlite3

---

FAQ

基础使用

EnsoAI 与普通 IDE 有什么区别？

EnsoAI 专注于 Git Worktree + AI Agent 的协作场景。它不是要替代 VS Code 或 Cursor，而是作为一个轻量级的工作空间管理器，让你能够： - 在多个 worktree 之间快速切换，每个 worktree 独立运行 AI Agent - 同时进行多个功能分支的开发，互不干扰 - 通过 "Open In" 功能随时跳转到你熟悉的 IDE 继续深度开发

支持哪些 AI Agent？

内置支持 Claude、Codex、Gemini、Cursor Agent、Droid、Auggie。你也可以在设置中添加任意支持 CLI 的 Agent，只需指定启动命令即可。

Agent 会话是否会保留？

是的。每个 worktree 的 Agent 会话独立保存，切换 worktree 后再切回来，之前的对话上下文仍然存在。

---

使用场景

什么时候应该使用 EnsoAI？

场景	说明
多任务并行开发	同时处理 feature-A 和 bugfix-B，每个分支有独立的 AI 会话和终端
AI 辅助 Code Review	在新 worktree 中让 AI 审查代码，主分支开发不受影响
实验性开发	创建临时 worktree 让 AI 自由实验，不满意直接删除
对比调试	同时打开多个 worktree 对比不同实现

为什么使用官方 CLI 而不使用 ACP？

虽然 ACP 能够统一不同 Agent 的核心能力，但是也仅限于核心能力缺失了很多功能。切换不同 Agent 的场景其实并不多而且不同 Agent 的 CLI 核心功能都相似。所以我们认为对于有经验的开发者各 CLI 更具有生产力。

EnsoAI 适合什么规模的项目？

中小型项目最为合适。对于大型 monorepo，建议配合 VS Code 等全功能 IDE 使用 —— EnsoAI 负责 worktree 管理和 AI 交互，IDE 负责深度开发。

---

开发流程

使用 EnsoAI 的典型开发流程是什么？

1. 打开 Workspace
   └── 选择或添加 Git 仓库

2. 创建/切换 Worktree
   └── 为新功能创建 worktree（自动关联新分支）

3. 启动 AI Agent
   └── 在 Agent 面板与 Claude/Codex 等对话
   └── AI 直接在当前 worktree 目录下工作

4. 编辑 & 测试
   └── 使用内置编辑器快速修改
   └── 使用终端运行测试/构建

5. 提交 & 合并
   └── 完成后在终端 git commit/push
   └── 或通过 "Open In" 跳转到 IDE 进行最终审查

如何高效管理多个并行任务？

1. 为每个任务创建独立 worktree（Cmd+N 或点击 + 按钮）
2. 使用快捷键 Cmd+1-9 快速切换 worktree
3. 每个 worktree 有独立的 Agent 会话、终端标签、编辑器状态
4. 完成后删除 worktree，可选择同时删除分支

AI Agent 生成的代码如何 review？

推荐流程： 1. 让 AI 在独立 worktree 中生成代码 2. 使用内置编辑器或 "Open In Cursor/VS Code" 审查 3. 满意后在终端提交；不满意可继续对话修改或直接删除 worktree

---

快捷键

常用快捷键有哪些？

快捷键	功能
Cmd+Shift+P	打开命令面板
Cmd+,	打开设置
Cmd+1-9	切换到对应标签
Cmd+T	新建终端/Agent 会话
Cmd+W	关闭当前终端/会话
Cmd+S	保存文件
Shift+Enter	终端中输入换行

---

故障排除

Agent 无法启动？

1. 确认对应 CLI 工具已安装（如 claude、codex）
2. 在终端中手动运行命令验证
3. 检查设置中的 Agent 路径配置

终端显示异常/花屏？

进入设置 → 终端 → 将渲染器从 WebGL 切换为 DOM。

---

License

MIT License - 详见 LICENSE。