Multiple Agents, Parallel Flow
Unleash parallel intelligence within a single project.
Let Claude, Gemini, and Codex weave through different worktrees simultaneously without context switching.
Stop stashing and popping. EnsoAI treats every branch as a first-class workspace with its own dedicated AI context.
macOS (Homebrew)
brew tap j3n5en/ensoai
brew install --cask ensoaiWindows (Scoop)
scoop bucket add ensoai https://github.com/J3n5en/scoop-ensoai
scoop install ensoaiWindows (Winget)
winget install J3n5en.EnsoAIDownload the installer for your platform from GitHub Releases:
| 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 |
# 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 # LinuxSeamlessly 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.
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
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
Auto-generate high-quality commit messages and perform deep code reviews using your favorite AI agents.
Built-in professional 3-way merge editor. Clearly visualize conflict sources and resolve them with a single click and real-time result preview.
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
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.
- 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
- Framework: Electron + React 19 + TypeScript
- Styling: Tailwind CSS 4
- Editor: Monaco Editor
- Terminal: xterm.js + node-pty
- Git: simple-git
- Database: better-sqlite3
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.
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.
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?
- Create a separate worktree for each task (
Cmd+Nor click + button) - Use
Cmd+1-9to quickly switch between worktrees - Each worktree has independent Agent sessions, terminal tabs, and editor state
- Delete worktree when done, optionally delete the branch too
How to review AI-generated code?
Recommended workflow:
- Let AI generate code in a separate worktree
- Review using built-in editor or "Open In Cursor/VS Code"
- Commit in terminal if satisfied; continue the conversation or delete the worktree if not
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 |
Agent won't start?
- Verify the CLI tool is installed (e.g.,
claude,codex) - Manually run the command in terminal to verify
- Check Agent path configuration in settings
Terminal display issues/artifacts?
Go to Settings → Terminal → Switch renderer from WebGL to DOM.
MIT License - see LICENSE for details.
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}
