EnsoAI is a desktop application designed to streamline development workflows by combining Git Worktree management with AI coding agents. It provides a unified workspace where developers can manage multiple Git worktrees while leveraging AI assistants like Claude, Codex, and Gemini to enhance their coding experience.
Key Features:
Multi-Agent Support: Seamlessly integrate and switch between AI agents such as Claude, Codex, and Gemini, each with independent session persistence for different worktrees.
Unified Worktree Management: Create, switch, and manage Git worktrees in milliseconds, enabling efficient multitasking across multiple branches.
Built-in Code Editing and Review: Use a lightweight Monaco-based editor for coding and utilize AI-driven code reviews to generate high-quality commit messages and optimize code changes.
Three-Way Merge Tool: Access an advanced three-column merge editor for resolving conflicts with real-time previews and clear source visibility.
Audience & Benefit:
Ideal for developers working on complex projects with multiple parallel tasks, EnsoAI offers a seamless way to manage Git worktrees and AI-driven development. By enabling efficient multitasking and streamlining code review processes, it helps developers accelerate their workflow without compromising on quality or context.
README
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.
# 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
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?
Create a separate worktree for each task (Cmd+N or click + button)
Use Cmd+1-9 to 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
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?
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.
