EnsoAI
Multiple Agents, Parallel Flow
Install / Use
/learn @J3n5en/EnsoAIREADME
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)
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
Manual Download
Download 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 |
Build from Source
# 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
<details> <summary><strong>How is EnsoAI different from a regular IDE?</strong></summary>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
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.
</details> <details> <summary><strong>Are Agent sessions preserved?</strong></summary>Yes. Each worktree's Agent session is saved independently. When you switch back to a worktree, the previous conversation context is still there.
</details>Use Cases
<details> <summary><strong>When should I use EnsoAI?</strong></summary>| 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 |
</details> <details> <summary><strong>Why use official CLIs instead of ACP?</strong></summary>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.
</details> <details> <summary><strong>What project size is EnsoAI suitable for?</strong></summary>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.
</details>Development Workflow
<details> <summary><strong>What's a typical development workflow with EnsoAI?</strong></summary>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
- 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
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
<details> <summary><strong>What are the common keyboard shortcuts?</strong></summary>| Shortcut | Function |
|----------|----------|
| Cmd+Shift+P | Open command palette |
| Cmd+, | Open settings |
| Cmd+1-9 | Switch to corresponding
Related Skills
node-connect
338.7kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
83.6kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
338.7kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
83.6kCommit, push, and open a PR
