EnsoAI
Multiple Agents, Parallel Flow
Unleash parallel intelligence within a single project.
Let Claude, Gemini, and Codex weave through different worktrees simultaneously without context switching.
中文 | English
---
## Workflow, Reimagined.
Stop stashing and popping. EnsoAI treats every branch as a first-class workspace with its own dedicated AI context.
---
## Installation
### Package Managers (Recommended)
**macOS (Homebrew)**
```bash
brew tap j3n5en/ensoai
brew install --cask ensoai
```
**Windows (Scoop)**
```powershell
scoop bucket add ensoai https://github.com/J3n5en/scoop-ensoai
scoop install ensoai
```
**Windows (Winget)**
```powershell
winget install J3n5en.EnsoAI
```
### Manual Download
Download the installer for your platform from [GitHub Releases](https://github.com/J3n5en/EnsoAI/releases/latest):
| Platform | File |
|----------|------|
| macOS (Apple Silicon) | `EnsoAI-x.x.x-arm64.dmg` |
| macOS (Intel) | `EnsoAI-x.x.x.dmg` |
| Windows (Installer) | `EnsoAI-Setup-x.x.x.exe` |
| Windows (Portable) | `EnsoAI-x.x.x-portable.exe` |
| Linux (AppImage) | `EnsoAI-x.x.x.AppImage` |
| Linux (deb) | `ensoai_x.x.x_amd64.deb` |
### Build from Source
```bash
# Clone the repository
git clone https://github.com/J3n5en/EnsoAI.git
cd EnsoAI
# Install dependencies (requires Node.js 20+, pnpm 10+)
pnpm install
# Run in development mode
pnpm dev
# Build for production
pnpm build:mac # macOS
pnpm build:win # Windows
pnpm build:linux # Linux
```
---
## Features
### Multi-Agent Matrix
Seamlessly switch between Claude, Codex, Gemini, and local LLMs. Each worktree gets its own persistent AI session.
Built-in support:
- **Claude** - Anthropic's AI assistant with session persistence
- **Codex** - OpenAI's coding assistant
- **Gemini** - Google's AI assistant
- **Cursor** - Cursor's AI agent (`cursor-agent`)
- **Droid** - Factory CLI for AI-powered CI/CD
- **Auggie** - Augment Code's AI assistant
You can also add custom agents by specifying the CLI command.
---
### Visual Source Control
Review diffs, stage changes, and manage commits with a beautiful, keyboard-centric Git interface.
- Change list showing all modified files
- Stage/unstage operations
- Commit history browser
- Code diff view
---
### Integrated File Editor
Built-in Monaco editor for quick edits. Syntax highlighting for 50+ languages with drag-and-drop multi-tab support.
- Multi-tab editing with drag-and-drop reorder
- File tree with create/rename/delete operations
- Automatic language detection
- Editor state persistence across sessions
---
### AI Code Review
Auto-generate high-quality commit messages and perform deep code reviews using your favorite AI agents.
---
### 3-Way Merge Tool
Built-in professional 3-way merge editor. Clearly visualize conflict sources and resolve them with a single click and real-time result preview.
---
### Git Worktree Management
Create, switch, and manage Git worktrees instantly. No more context switching costs between branches.
- Create worktrees from existing or new branches
- Switch between worktrees instantly
- Delete worktrees with optional branch cleanup
- Visual worktree list with branch status
---
### IDE Bridge
Use EnsoAI for orchestration, then jump into VS Code or Cursor for deep diving with a single click.
Quick access to all actions via `Cmd+Shift+P`:
- **Panel Control** - Toggle Workspace/Worktree sidebar visibility
- **Settings** - Open settings dialog (Cmd+,)
- **Open In** - Open current project in Cursor, Ghostty, VS Code, etc.
---
### Additional Features
- **Multi-Window Support** - Open multiple workspaces simultaneously
- **Theme Sync** - Sync app theme with terminal theme (400+ Ghostty themes)
- **Keyboard Shortcuts** - Efficient navigation (Cmd+1-9 to switch tabs)
- **Settings Persistence** - All settings saved to JSON for easy recovery
---
## Tech Stack
- **Framework**: Electron + React 19 + TypeScript
- **Styling**: Tailwind CSS 4
- **Editor**: Monaco Editor
- **Terminal**: xterm.js + node-pty
- **Git**: simple-git
- **Database**: sqlite3
---
## FAQ
### Basic Usage
How is EnsoAI different from a regular IDE?
EnsoAI focuses on **Git Worktree + AI Agent** collaboration. It's not meant to replace VS Code or Cursor, but rather serves as a lightweight workspace manager that allows you to:
- Quickly switch between multiple worktrees, each running an independent AI Agent
- Develop multiple feature branches simultaneously without interference
- Jump to your preferred IDE anytime via "Open In" for deeper development
Which AI Agents are supported?
Built-in support for Claude, Codex, Gemini, Cursor Agent, Droid, and Auggie. You can also add any CLI-based agent in settings by specifying the launch command.
Are Agent sessions preserved?
Yes. Each worktree's Agent session is saved independently. When you switch back to a worktree, the previous conversation context is still there.
---
### Use Cases
When should I use EnsoAI?
| Scenario | Description |
|----------|-------------|
| **Parallel Development** | Work on feature-A and bugfix-B simultaneously, each branch has independent AI sessions and terminals |
| **AI-Assisted Code Review** | Let AI review code in a new worktree without affecting main branch development |
| **Experimental Development** | Create a temporary worktree for AI to experiment freely, delete if unsatisfied |
| **Comparison Debugging** | Open multiple worktrees side by side to compare different implementations |
Why use official CLIs instead of ACP?
While ACP can unify core capabilities across different Agents, it's limited to just those core features and lacks many functionalities. Switching between different Agents isn't a common scenario, and the core features of different Agent CLIs are quite similar. We believe that for experienced developers, the native CLIs are more productive.
What project size is EnsoAI suitable for?
Best suited for small to medium projects. For large monorepos, we recommend using it alongside VS Code or similar full-featured IDEs — EnsoAI handles worktree management and AI interaction, while the IDE handles deep development.
---
### Development Workflow
What's a typical development workflow with EnsoAI?
```
1. Open Workspace
└── Select or add a Git repository
2. Create/Switch Worktree
└── Create a worktree for new feature (auto-creates branch)
3. Start AI Agent
└── Chat with Claude/Codex in the Agent panel
└── AI works directly in the current worktree directory
4. Edit & Test
└── Quick edits with built-in editor
└── Run tests/builds in terminal
5. Commit & Merge
└── Git commit/push in terminal
└── Or use "Open In" to jump to IDE for final review
```
How to efficiently manage multiple parallel tasks?
1. Create a separate worktree for each task (`Cmd+N` or click + button)
2. Use `Cmd+1-9` to quickly switch between worktrees
3. Each worktree has independent Agent sessions, terminal tabs, and editor state
4. Delete worktree when done, optionally delete the branch too
How to review AI-generated code?
Recommended workflow:
1. Let AI generate code in a separate worktree
2. Review using built-in editor or "Open In Cursor/VS Code"
3. Commit in terminal if satisfied; continue the conversation or delete the worktree if not
---
### Keyboard Shortcuts
What are the common keyboard shortcuts?
| Shortcut | Function |
|----------|----------|
| `Cmd+Shift+P` | Open command palette |
| `Cmd+,` | Open settings |
| `Cmd+1-9` | Switch to corresponding tab |
| `Cmd+T` | New terminal/Agent session |
| `Cmd+W` | Close current terminal/session |
| `Cmd+S` | Save file |
| `Shift+Enter` | Insert newline in terminal |
---
### Troubleshooting
Agent won't start?
1. Verify the CLI tool is installed (e.g., `claude`, `codex`)
2. Manually run the command in terminal to verify
3. Check Agent path configuration in settings
Terminal display issues/artifacts?
Go to Settings → Terminal → Switch renderer from WebGL to DOM.
---
## License
MIT License - see [LICENSE](LICENSE) for details.