Hydra automatically routes every developer task to the right AI model — using Claude when it matters, Ollama when it's free. Ten tiers, automatic fallbacks, zero Python required.
One brain, nine heads. Claude Code classifies and orchestrates — every other tier executes. Click a layer to explore its role.
Claude Code resides at the top of the hierarchy. It classifies incoming developer intents, breaks them down using workspace maps, and manages the execution flow. It writes the files, reviews execution logs, and coordinates parallel tasks.
Pick the complexity tier that matches your task, type what you need, and copy the exact dispatch command to run.
decide.sh reviews parameters and flags formatting structures.
scope.sh checks directories to ensure write safety.
edit.sh writes code atomically and executes validation.
Every file has a specific job. Click any entry to see exactly what it does and how it fits into the routing pipeline.
Executes the compiled Bun application of the React TUI. Run this locally to launch the interactive terminal dashboard to monitor all active token allocations, model executions, and costs.
#!/usr/bin/env bash # Launch Hydra TUI — run this directly in your terminal exec bun "$(dirname "$0")/ui/src/index.tsx"
Experience the React/Ink console dashboard interface directly. Cycle model tiers and submit queries to run a simulated dispatch.
Each tier is purpose-built — from a free local Qwen model for boilerplate to Claude Opus for architecture decisions. Route.sh picks the right one automatically.
| Tier | Complexity Enum | Target Model | Executor | Accuracy Rating | Cost Weight |
|---|---|---|---|---|---|
| 1 | CORE | Claude Code | Direct Shell |
|
$$$$$ |
| 2 | EXPERT | Claude 4.6 Opus (Thinking) | Antigravity |
|
$$$$ |
| 3 | VERY_HARD | Claude 4.6 Sonnet (Thinking) | Antigravity |
|
$$$ |
| 4 | HARD | Gemini 2.0 Flash Thinking | Antigravity |
|
$$ |
| 5 | COMPLEX | Gemini 3.1 Pro (High) | Antigravity |
|
$$ |
| 6 | MODERATE | Gemini 3.1 Pro (Low) | Antigravity |
|
$ |
| 7 | STANDARD | Gemini 3.5 Flash (High) | Antigravity |
|
$ |
| 8 | SIMPLE | Gemini 3.5 Flash (Medium) | Antigravity |
|
$ |
| 9 | TRIVIAL | Gemini 3.5 Flash (Low) | Antigravity |
|
$ |
| 10 | GRUNT | Qwen 2.5 Coder 7B | Local Ollama |
|
Free |
Three steps to get Hydra running. Install dependencies, clone the repo, and launch the TUI — you'll be routing tasks in under five minutes.
Install locally from the cloned repository:
brew install --HEAD Formula/hydra.rb
Or tap and install the published package:
brew tap ankit373/hydra && brew install hydra
Copies all modules to ~/.hydra, installs Bun dependencies, seeds the local state.json, writes the launch script, and automatically registers them in your shell configuration profile (~/.zshrc / ~/.bashrc).
./install.sh
Clone the source code manually and install dependencies. Excellent for hacking on the TUI dashboard or customizing router scripts.
git clone https://github.com/ankit373/hydra.git && cd hydra/ui && bun install
Hydra isolates core read-only scripts from mutable runtime state:
• HYDRA_HOME: Resolves env var -> local auto-detection (repo mode) -> falls back to ~/.hydra.
• HYDRA_DATA: All mutable logs and state (like state.json, cost.jsonl) are stored here (defaults to ~/.hydra). Override by setting export HYDRA_DATA="/your/path".
Display active Antigravity allocations, Claude token percentages, and pool status.
hydra status
Send instructions directly to a specific model tier by its complexity enum key.
hydra do SIMPLE "write a User DTO class in TypeScript"
Execute a peer evaluation on a code snippet using a different model family to avoid shared biases.
hydra duck "$(cat src/auth.ts)"
Launch the React TUI directly in your console (make sure to run outside of standard IDE shells).
hydra-ui
Press Tab inside the input console to cycle the complexity key (e.g., standard to simple).
Review real-time cost accumulations and active model metrics on the top status panel.
Type /hydra inside a running Claude Code CLI interactive session.
Specify complexity tiers and prompts right in your chat window without leaving the session.
/hydra do SIMPLE "write a User DTO class in TypeScript"
Claude Code intercepts the command, coordinates with route.sh, and applies the outputs directly back to your workspace.
Hydra is MIT licensed and built in the open. Ask questions, report bugs, request features, or send a pull request — all from here.