EnsoAI

多智能体，并行流程

在单个项目中释放并行智能。
让Claude、Gemini和Codex无需切换上下文，即可同时穿梭于不同的工作树之间。

中文 | English

工作流程，全新定义。

不再需要 stash 和 pop。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 下载适用于您平台的安装程序：

从源码构建

# 克隆仓库
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

功能

多智能体矩阵

无缝切换 Claude、Codex、Gemini 和本地 LLM。每个工作树都有自己的持久化 AI 会话。

内置支持：

• Claude - Anthropic 的 AI 助手，支持会话持久化
• Codex - OpenAI 的编程助手
• Gemini - Google 的 AI 助手
• Cursor - Cursor 的 AI 代理 (cursor-agent)
• Droid - 用于 AI 驱动 CI/CD 的工厂 CLI
• Auggie - Augment Code 的 AI 助手

您也可以通过指定 CLI 命令添加自定义智能体。

可视化版本控制

使用美观且以键盘为中心的 Git 界面，查看差异、暂存更改并管理提交。

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

集成文件编辑器

内置 Monaco 编辑器，方便快速编辑。支持 50 多种语言的语法高亮，并可拖放多标签页。

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

AI 代码审查

利用您喜爱的 AI 智能体自动生成高质量的提交信息，并进行深度代码审查。

三路合并工具

内置专业的三路合并编辑器。清晰地可视化冲突来源，并可通过一键操作实时预览结果来解决冲突。

Git 工作树管理

即时创建、切换和管理 Git 工作树。无需再为分支之间的上下文切换付出代价。

• 可从现有或新分支创建工作树
• 瞬间切换工作树
• 可选择性清理分支后删除工作树
• 可视化的工作树列表及分支状态

IDE 桥接

使用 EnsoAI 进行编排，然后只需点击一下即可跳转到 VS Code 或 Cursor 中深入开发。

通过 Cmd+Shift+P 快速访问所有功能：

• 面板控制 - 切换工作区/工作树侧边栏的可见性
• 设置 - 打开设置对话框（Cmd+,）
• 在…中打开 - 将当前项目在 Cursor、Ghostty、VS Code 等中打开

其他特性

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

技术栈

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

常见问题解答

基本用法

使用场景

开发工作流

1. 打开工作区
   └── 选择或添加一个 Git 仓库

2. 创建/切换工作树
   └── 为新功能创建一个工作树（自动创建分支）

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

4. 编辑与测试
   └── 使用内置编辑器快速编辑
   └── 在终端中运行测试或构建

5. 提交与合并
   └── 在终端中进行 Git 提交/推送
   └── 或者使用“Open In”跳转到 IDE 进行最终审查

键盘快捷键

故障排除

许可证

MIT 许可证 - 详情请参阅 LICENSE。

EnsoAI 快速上手指南

EnsoAI 是一款专为并行开发设计的 AI 工作流工具。它利用 Git Worktree 技术，让 Claude、Gemini、Codex 等多个 AI 代理在不同的分支工作区中同时运行，无需频繁切换上下文或暂存代码。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：macOS (Intel/Apple Silicon), Windows, 或 Linux。
• Node.js：版本 20 或更高（仅源码构建时需要）。
• 包管理器（推荐用于安装）：
  • macOS: Homebrew
  • Windows: Scoop 或 Winget
• AI 代理 CLI：根据需求预先安装对应的命令行工具（如 claude, codex, gemini 等），EnsoAI 将调用这些原生 CLI 进行交互。

安装步骤

您可以根据操作系统选择最便捷的安装方式。

方式一：使用包管理器（推荐）

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 下载对应平台的安装包：

方式三：源码构建

如果您需要自定义构建，请执行以下命令：

# 克隆仓库
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

基本使用

以下是使用 EnsoAI 进行并行开发的最简流程：

1. 打开项目

启动 EnsoAI，选择或添加一个现有的 Git 仓库作为工作空间。

2. 创建并行工作区 (Worktree)

为新的功能开发或 Bug 修复创建独立的工作区，每个工作区拥有独立的 Git 分支和 AI 会话：

• 点击界面上的 + 按钮或使用快捷键 Cmd+N (macOS) / Ctrl+N (Windows)。
• 输入新分支名称，EnsoAI 将自动基于当前分支创建新的 Git Worktree。

3. 启动 AI 代理

在新建的工作区侧边栏中：

• 选择所需的 AI 代理（如 Claude, Codex, Gemini 等）。
• 开始对话。AI 将直接在当前工作区的文件系统中读写代码，不会干扰其他分支的开发。

4. 编辑与审查

• 内置编辑：使用集成的 Monaco 编辑器进行快速修改，支持语法高亮和多标签页。
• 代码审查：利用内置的 Git 面板查看差异、暂存更改，或使用 "3-Way Merge Tool" 解决冲突。
• 提交代码：在终端中直接执行 git commit，或使用界面生成的 AI 提交信息。

5. 切换与协作

• 使用快捷键 Cmd+1 到 Cmd+9 在不同工作区之间瞬间切换。
• 如需深度开发，可按 Cmd+Shift+P 打开命令面板，选择 Open In 将当前工作区一键跳转至 VS Code 或 Cursor。

6. 清理工作区

任务完成后，可在列表中删除该 Worktree，并选择是否同时删除对应的 Git 分支，保持仓库整洁。