https://github.com/stefanhoelzl/codehydra

Multi-Workspace IDE for Parallel AI Agent Development
https://github.com/stefanhoelzl/codehydra

agent ai claude-code ide opencode vscode worktrees

Last synced: 3 days ago
JSON representation

Multi-Workspace IDE for Parallel AI Agent Development

• Host: GitHub
• URL: https://github.com/stefanhoelzl/codehydra
• Owner: stefanhoelzl
• License: mit
• Created: 2025-12-02T19:56:36.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-02-12T06:14:18.000Z (10 days ago)
• Last Synced: 2026-02-12T16:21:24.293Z (9 days ago)
• Topics: agent, ai, claude-code, ide, opencode, vscode, worktrees
• Language: TypeScript
• Homepage: https://codehydra.dev/
• Size: 6.3 MB
• Stars: 9
• Watchers: 2
• Forks: 2
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          


  

  
CodeHydra

  
Multi-workspace IDE for parallel AI agent development


[![CI](https://github.com/stefanhoelzl/codehydra/actions/workflows/ci.yaml/badge.svg)](https://github.com/stefanhoelzl/codehydra/actions/workflows/ci.yaml)

[![npm](https://img.shields.io/npm/v/codehydra)](https://www.npmjs.com/package/codehydra)

[![PyPI](https://img.shields.io/pypi/v/codehydra)](https://pypi.org/project/codehydra/)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey)



---

Run multiple AI coding assistants simultaneously in isolated git worktrees

with real-time status monitoring.

## Installation

```bash

# Using Node.js

npx codehydra

# Using Python

uvx codehydra

```

Or download directly from [GitHub Releases](https://github.com/stefanhoelzl/codehydra/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

## Screenshot

> Screenshots coming soon

## 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](LICENSE) - 2025 CodeHydra