Skip to content

Getting Started

Ankit Jha edited this page May 29, 2026 · 1 revision

Getting Started

Prerequisites

Dependency Install
Bun `curl -fsSL https://bun.sh/install
Antigravity CLI follow repo instructions
Ollama brew install ollama (macOS)
Qwen2.5-Coder model ollama pull Qwen2.5-Coder:7b

Installation

1. Clone

git clone https://github.com/ankit373/hydra.git && cd hydra

2. Install TUI dependencies

cd ui && bun install && cd ..

3. Pull the local model (~4.7GB, one time)

ollama pull Qwen2.5-Coder:7b

4. Verify

bash dispatch/route.sh --status
bash dispatch/route.sh --list

CLI Usage

# Status
./dispatch/hydra.sh status

# Dispatch by tier
./dispatch/hydra.sh do SIMPLE "write a User DTO in TypeScript"
./dispatch/hydra.sh do STANDARD "add pagination to UsersController"
./dispatch/hydra.sh do MODERATE "write a UserService with CRUD and validation"
./dispatch/hydra.sh do COMPLEX "implement JWT authentication middleware"

# Rubber duck review (Gemini Flash Thinking — different family from Claude)
./dispatch/hydra.sh duck "$(cat src/auth.ts)"

# With file context
bash dispatch/route.sh --enum STANDARD --prompt "add pagination" --context src/users/controller.ts

TUI (Terminal Dashboard)

./hydra-ui
Key Action
Tab Cycle model tiers
Esc Quit
Command Description
/status Show Claude % and pool state
/tiers List active model tiers
/set-pct <n> Manually set claude_pct
/reset-pools Clear exhausted pool flags

Review Changes

bash dispatch/review.sh summary   # see what changed
bash dispatch/review.sh diff      # view the diff
bash dispatch/review.sh approve   # stage + remove backups
bash dispatch/review.sh reject    # rollback all

Cost Analysis

bash dispatch/cost.sh by-tier
bash dispatch/cost.sh by-day

Clone this wiki locally