CodeHydra

Multi-workspace IDE for parallel AI agent development.

Installation

# Run directly without installation
uvx --refresh codehydra

# Or install globally
pip install codehydra
codehydra

Features

Run Claude Code or OpenCode in several isolated git worktrees at once
Real-time agent status monitoring across all workspaces
Keyboard-driven navigation (Alt+X shortcut mode)
A full VSCodium editor per workspace, with your extensions, themes and settings
Agents can run any VS Code command through the built-in MCP server

How It Works

This package downloads the appropriate CodeHydra binary for your platform from GitHub Releases on first run, caches it locally, and executes it with any passed arguments.

Supported platforms:

Linux x64
macOS x64 and arm64
Windows x64

License

MIT

Release files for codehydra 2026.9.12

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codehydra 2026.9.12
File	Size	Uploaded
codehydra-2026.9.12.tar.gz	2.9 kB	Sep 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for codehydra 2026.9.12
File	Interpreter	ABI	Platform	Reset
codehydra-2026.9.12-py3-none-any.whl 3.8 kB Sep 12, 2026	Python 3	none	any	Details

Total release size: 6.7 kB

Release files / codehydra-2026.9.12.tar.gz

Download URL	codehydra-2026.9.12.tar.gz
Size	2.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`934c1bb57bd2deeff04bebd7f6169784a01f40b231100be1f94db6e089c8216f`
BLAKE2b-256 checksum How to use checksums	`94085cc736f3eea2ab267d5583381e687aa98df6227749bf6d24af17fcaad982`
Upload date	Sep 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/stefanhoelzl/codehydra
Publishing commit: github.com/stefanhoelzl/codehydra/tree/bdbe3f1db46d0942a87f276988bd6075c747be56

Workflow

Publishing configuration: github.com/stefanhoelzl/codehydra/blob/bdbe3f1db46d0942a87f276988bd6075c747be56/.github/workflows/release.yaml
Publishing logs: github.com/stefanhoelzl/codehydra/actions/runs/34678550805/attempts/1

Artifact

Subject: codehydra-2026.9.12.tar.gz
SHA-256 checksum: 934c1bb57bd2deeff04bebd7f6169784a01f40b231100be1f94db6e089c8216f Verifying attestations

Release files / codehydra-2026.9.12-py3-none-any.whl

Download URL	codehydra-2026.9.12-py3-none-any.whl
Size	3.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`59e3bfe3cb57ce2f3b7b2eefc4ec73050a98f49202805cfcfafb6be479997649`
BLAKE2b-256 checksum How to use checksums	`c8baeb5e8769b2f624da044069ad08ee6ab0c0145976ab62e5c9b549266eb777`
Upload date	Sep 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/stefanhoelzl/codehydra
Publishing commit: github.com/stefanhoelzl/codehydra/tree/bdbe3f1db46d0942a87f276988bd6075c747be56

Workflow

Publishing configuration: github.com/stefanhoelzl/codehydra/blob/bdbe3f1db46d0942a87f276988bd6075c747be56/.github/workflows/release.yaml
Publishing logs: github.com/stefanhoelzl/codehydra/actions/runs/34678550805/attempts/1

Artifact

Subject: codehydra-2026.9.12-py3-none-any.whl
SHA-256 checksum: 59e3bfe3cb57ce2f3b7b2eefc4ec73050a98f49202805cfcfafb6be479997649 Verifying attestations