Orchestrate multi-agent AI workflows in Claude Code by delegating tasks to 10 specialized Haiku/Sonnet subagents coordinated by Opus, handling code reviews, bug fixes, refactoring, git operations, security scans, test runs, environment preflights, and documentation with ~50% API cost reduction via speculative decoding.
npx claudepluginhub ar6420/hail_hydraShow current Hydra configuration and how to customize it
Manually run the Hydra security and quality scan on specified files or directories
Show all available Hydra commands, agents, and a quick reference guide
View, rebuild, or query the codebase dependency map
Run two-phase environment and compatibility check before starting a new project build
Suppress Hydra dispatch logs for the rest of this session
Report a bug, request a feature, or share feedback about Hydra
Show Hydra framework status — installed agents, version, config, and update availability
Update the Hydra framework to the latest version from npm
Enable verbose Hydra dispatch logs with timing and token estimates
🔵 Hydra's analysis head — thorough code review, debugging, and analysis agent. Use PROACTIVELY whenever Claude needs to review code for quality, analyze a bug with error messages or stack traces, evaluate dependencies, assess test coverage, review pull request changes, identify performance issues, or analyze technical debt. Runs on Sonnet 4.6 for strong reasoning at good speed. May run in parallel with other Hydra agents — produces self-contained, clearly structured output so the orchestrator can merge results from multiple simultaneous agents.
🔵 Hydra's implementation head — capable code writing and engineering agent. Use PROACTIVELY whenever Claude needs to write new code, implement features, refactor existing code, create or modify tests, fix bugs with clear error messages, make API integrations, or perform any code writing task that follows well-understood patterns. Runs on Sonnet 4.6 for a strong balance of speed and capability. Use this for all standard implementation work — reserve Opus 4.6 only for novel architecture or extremely subtle debugging. May run in parallel with other Hydra agents — produces self-contained, clearly structured output so the orchestrator can merge results from multiple simultaneous agents.
🟢 Hydra's git operations specialist. Handles all version control tasks: staging, committing with well-crafted Conventional Commits messages, branching, merging, rebasing, stashing, cherry-picking, log inspection, diff analysis, and conflict detection. Runs on Haiku 4.5 — git operations are mechanical and well-defined. Use hydra-analyst for merge conflict RESOLUTION (requires code comprehension) but hydra-git for conflict DETECTION and all other git operations. May run in parallel with other Hydra agents — produces self-contained, clearly structured output so the orchestrator can merge results from multiple simultaneous agents.
🟢 Hydra's security and quality gate agent. Automatically invoked after hydra-coder (Sonnet 4.6) produces code changes. Performs a fast scan for common security issues (hardcoded secrets, SQL injection, XSS, unsafe deserialization, exposed API keys), code quality checks (unused imports, dead code, missing error handling on async operations), and leftover debug artifacts (console.log, TODO/FIXME/HACK comments). Runs on Haiku 4.5 for speed — this is a fast gate, not a deep audit. For deep security review, use hydra-analyst instead. May run in parallel with other Hydra agents — produces self-contained, clearly structured output so the orchestrator can merge results from multiple simultaneous agents.
Environment and dependency preflight check for new projects. Detects runtime versions, runs compatibility probe scripts, collects the full dependency tree, and returns a structured inventory for cross-component analysis. Use when the user runs /hydra:preflight or when starting work on a new or unfamiliar project.
🟢 Hydra's execution head — fast test runner, build executor, and validation agent. Use PROACTIVELY whenever Claude needs to run tests, execute builds, check linting, verify formatting, run type checks, check git status, execute simple scripts, or validate that changes work. Runs on Haiku 4.5 for speed — ideal for quick feedback loops during development. May run in parallel with other Hydra agents — produces self-contained, clearly structured output so the orchestrator can merge results from multiple simultaneous agents.
🟢 Hydra's fastest head — ultra-fast codebase exploration, information retrieval, and codebase map building/maintenance. Use PROACTIVELY whenever Claude needs to search files, read code, find patterns, grep for strings, list directories, understand project structure, answer "where is X?" questions, or build/update the codebase dependency map. This is the first head to reach for when gathering information before making changes. Runs on Haiku 4.5 for near-instant responses. May run in parallel with other Hydra agents — produces self-contained, clearly structured output so the orchestrator can merge results from multiple simultaneous agents.
🟢 Hydra's documentation head — fast technical writing agent. Use PROACTIVELY whenever Claude needs to write or update README files, add code comments or docstrings, create changelogs, write API documentation, update configuration docs, or produce any technical writing that describes existing code. Runs on Haiku 4.5 for speed — documentation from existing code is largely descriptive and doesn't need heavy reasoning. May run in parallel with other Hydra agents — produces self-contained, clearly structured output so the orchestrator can merge results from multiple simultaneous agents.
Fast integration sweep after code changes. Checks for broken imports, missing exports, changed function signatures, missing env vars, circular dependencies, and changed API routes. Runs on Haiku 4.5 for speed. If issues are found, the orchestrator escalates to hydra-sentinel for deep analysis. If clean — done, zero additional cost.
Deep integration analysis triggered when sentinel-scan flags issues. Validates inter-component contracts, traces data flow across boundaries, confirms or dismisses findings from the fast scan, and provides specific fix suggestions. Runs on Sonnet 4.6 for accuracy.
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Uses power tools
Uses Bash, Write, or Edit tools
You know how in the movies, Hydra had agents embedded everywhere, silently getting things done in the background? That's exactly what this framework does for your Claude Code sessions.
Hydra is a task-level speculative execution framework inspired by Speculative Decoding in LLM inference. Instead of making one expensive model (Opus 4.6) do everything — from searching files to writing entire modules — Hydra deploys a team of specialized "heads" running on faster, cheaper models that handle the grunt work.
The result? Opus becomes a manager, not a laborer. It classifies tasks, dispatches them to the right head, glances at the output, and moves on. The user never notices. It's invisible. It's always on.
New in v2.0.0: Every agent now has persistent memory — they learn your codebase patterns, conventions, and architectural decisions across sessions. The orchestrator (Opus) also maintains its own memory of fragile zones and routing decisions. Plus, the new hydra-sentinel automatically catches integration breakage after code changes — and code isn't presented to you until verification completes.
New in v2.1.0: The Codebase Map gives every agent instant access to file dependencies, blast radius, risk scores, and test coverage — replacing slow grep-based scanning with instant JSON lookups. Sentinel is now 3-5× faster and 3-5× cheaper per scan.
Four built-in speed optimizations reduce overhead at every stage: speculative pre-dispatch (scout launches in parallel with task classification), session indexing (codebase context persists across turns — no re-exploration), parallel dispatch (independent agents run simultaneously — Opus waits for all before responding), and confidence-based auto-accept (raw factual outputs skip Opus review entirely).
Think of it this way:
Would you hire a $500/hr architect to carry bricks? No. You'd have them design the building and let the crew handle construction. That's Hydra.
One command. Done.
npx hail-hydra-cc@latest
[OR]
npm i hail-hydra-cc@latest
Runs the interactive installer — deploys 10 agents, 10 slash commands, 4 hooks, and registers the statusline and update checker. Done in seconds.
# Clone the repo
git clone https://github.com/AR6420/Hail_Hydra.git
cd hydra
# Deploy heads globally (recommended — always on, every project)
./scripts/install.sh --user
# 🐉 Hail Hydra! Framework active in all Claude Code sessions.
# ✅ 10 agents ✅ 10 commands ✅ 4 hooks ✅ StatusLine ✅ VERSION
# User-level — available in ALL your Claude Code projects
./scripts/install.sh --user
# Project-level — just this one project
./scripts/install.sh --project
# Both — maximum coverage
./scripts/install.sh --both
Use this agent when you need expert assistance with React Native development tasks including code analysis, component creation, debugging, performance optimization, or architectural decisions. Examples: <example>Context: User is working on a React Native app and needs help with a navigation issue. user: 'My stack navigator isn't working properly when I try to navigate between screens' assistant: 'Let me use the react-native-dev agent to analyze your navigation setup and provide a solution' <commentary>Since this is a React Native specific issue, use the react-native-dev agent to provide expert guidance on navigation problems.</commentary></example> <example>Context: User wants to create a new component that follows the existing app structure. user: 'I need to create a custom button component that matches our app's design system' assistant: 'I'll use the react-native-dev agent to create a button component that aligns with your existing codebase structure and design patterns' <commentary>The user needs React Native component development that should follow existing patterns, so use the react-native-dev agent.</commentary></example>
Access thousands of AI prompts and skills directly in your AI coding assistant. Search prompts, discover skills, save your own, and improve prompts with AI.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.