CodeHydra

Multi-workspace IDE for parallel AI agent development

Run multiple AI coding assistants simultaneously in isolated git worktrees
with real-time status monitoring.

https://github.com/user-attachments/assets/82b56a86-3dee-42a6-90d3-e2a002949f7a

Installation

# Using Node.js
npx codehydra

# Using Python
uvx codehydra

Or download directly from GitHub Releases.

Features

Parallel Workspaces - Run multiple AI agents simultaneously, each in its own workspace
Git Worktrees - Each workspace is an isolated git worktree, not a separate clone
Real-time Status - Monitor agent status (idle/busy/waiting) across all workspaces
Keyboard Driven - Alt+X shortcut mode for fast workspace navigation
VS Code Powered - Full code-server integration with all your extensions
Voice Dictation - Built-in speech-to-text for hands-free coding
Cross-platform - Linux, macOS, and Windows

How It Works

CodeHydra uses git worktrees to create isolated workspaces from a single repository:

Concept	Description
Project	A git repository (the main directory)
Workspace	A git worktree - an isolated working copy with its own branch

Each workspace gets its own VS Code instance (via code-server) and can run an independent
AI agent. Switch between workspaces instantly while each agent continues working.

Development

Prerequisites

pnpm (manages Node.js version automatically)
Git

Commands

Command	Description
`pnpm dev`	Start in development mode
`pnpm build`	Build for production
`pnpm test`	Run all tests
`pnpm validate:fix`	Fix lint/format issues and run tests
`pnpm dist`	Create distributable for current OS

License

MIT - 2025 CodeHydra