Connect GitHub and Hyrax builds the map on its first run.
HYRAX.md + .hyrax/discovery · context for human and AI contributors
Security, correctness, maintainability, performance, architecture, and operations evaluate every repo from shared context.
Specialized judgment, prioritized by impact
Review what matters, dismiss what does not, and approve the improvements worth shipping.
Human control · stable HYRAX-N refs · approve, dismiss or request changes
Hyrax turns approved improvements into verified GitHub pull requests your team can review and merge.
Isolated worktree. Your tests. Your build. Human approval.
The codebase map updates as your repository changes, so the next run starts with better context.
Context compounds. Drift decreases.
Map the repository, architecture, dependencies, conventions, and constraints.
Identify the changes that will make the software stronger, easier to maintain, and easier to evolve.
Deliver improvements through GitHub with tests, checks, and human approval.
AI tools increased output. Hyrax gives that output architecture, context, and control.
Built for teams using Cursor, Copilot, Claude Code, Codex, and Devin.
Velocity got solved. Architecture did not.
Velocity vs. excellence
Autocomplete
Sync agents
Async agents
AI made writing code 17x faster while shipping barely moved. Speed alone doesn't build better products. The advantage now belongs to teams that turn velocity into excellence.
NBER Working Paper 35275, 100,000+ developers, 2026
Every approved improvement runs in an isolated worktree with your tests, build, and checks before it becomes a pull request.
Interactive demo of a Hyrax pull request review. Three changed files are open as tabs — env.ts, .env.example and env.test.ts — each showing its diff and a note on which existing repository convention the edit follows. Files can be switched, closed and restored, and the change can be approved or sent back for changes.
src/lib/env.ts
40import { requireEnv } from './env'4142-const STRIPE_KEY = "sk_live_51H8xQ2eZvKYlo2C"42+const STRIPE_KEY = requireEnv('STRIPE_SECRET_KEY')4344export const stripe = new Stripe(STRIPE_KEY)
Matches existing convention
Uses the repo's existing requireEnv helper from src/lib/env.ts rather than reading process.env inline, matching the 23 other call sites.
Coding agents increase output. Hyrax gives the resulting software persistent context, engineering judgment, and a path to continuous improvement.
Install the GitHub App and Hyrax writes the first codebase map into your repo. No CI rewrite. No new workflow to learn.
Install once. Improvements, PRs, issues and checks stay in GitHub.
Trigger workflows from Linear or API.
Improvement work connects to tickets automatically.
Human and AI contributors work from shared codebase context.
Discovery artifacts published to the storefront-web repository. A file rail lists HYRAX.md and 4 reference documents under .hyrax/discovery; the reading pane shows HYRAX.md.
Repository root
Agents read this first.
.hyrax/discovery
synced from Hyrax discovery — this file will be overwritten on next sync
Generated by Hyrax for shared codebase context. Content last changed: 2026-06-17. Discovery version: 15.
If you have 60 seconds: read Definition of Done and Non-Obvious Rules below. Open the linked docs on demand — don't pre-load them.
Before claiming a change is complete, the commands below must pass.
| Purpose | Command | Source |
|---|---|---|
| unit | pnpm test | package.json/scripts/test |
| types | pnpm typecheck | package.json/scripts/typecheck |
| build | pnpm build | package.json/scripts/build |
Order is fast to slow; run earlier rows first so cheap checks fail before expensive ones.
Number on a currency field is a bug.src/api/* returns the shared error envelope. Never a bare string.src/generated/ is written by codegen — edit the schema.Linked on demand, not pre-loaded.
.hyrax/discovery/architecture.md — module boundaries and data flow.hyrax/discovery/patterns.md — conventions with occurrence counts.hyrax/discovery/env-vars.md — required variables and their readersHow this team writes commits and PRs. Hyrax reads this so improvements match how the team works.
Unknown — no commit_style template set. Set one in the repo's Settings tab using the token grammar, e.g. [{hyrax_id}] {subject}.
user notes: content below this marker survives re-publish
Staging seeds are wiped every Sunday. Don't rely on fixture ids.
end user notes
Regenerated on every sync. Notes between the user-notes markers survive.
Pricing
Starter credits included. Paid seats add monthly credits.
The full product on your real repos. No card.
Same product. More credits.
You set the cap, Hyrax can't exceed it
Each paid user gets $30/month of credits. Overage is opt-in with budget caps you set. All AI inference runs on AWS Bedrock.
FAQ
Hyrax helps engineering teams understand what's happening across their codebase, identify what matters, and turn improvements into production-ready changes. It maps your codebase and understands how your product is built, then six specialized agents evaluate security, correctness, maintainability, performance, architecture and operations. The highest-leverage work becomes verified pull requests in GitHub. An engineer reviews and merges every one.
Free gives every workspace full access to Hyrax, a $30 starter credit, $10/month ongoing credit, and up to 100 PR reviews a month for free, with no card required. Paid is $30 per user per month, and each paid user gets $30/month of credits. Credits meter usage across repository mapping, verified improvements, and PR reviews; there are no feature walls. Overage is opt-in with budget caps.
The 13-step verification gate checks an improvement before it reaches your team as a pull request. It covers isolated worktree execution, the tests it started with, the tests after the change, your build, lint and formatting, a size limit on the diff, a second review by an independent agent, a re-scan to confirm the original issue is gone, and CI. If a required check fails, the work stops and never becomes a PR.
AI tools write code. Hyrax architects the system that code enters. Assistants edit what you point them at, and their context starts empty every session. Hyrax holds the map of your codebase, and six specialized agents reason about security, correctness, maintainability, performance, architecture and operations before anything ships. Use both.
Hyrax works through GitHub with human control, and it never merges on its own. Verification runs before a pull request reaches your team, and your engineers make the final call. All inference runs in the Hyrax AWS Bedrock account, and Hyrax does not train on customer code.
Start free
Hyrax is free to start. Full product, $30 starter credit, $10/month of credits. No credit card.
The Dispatch
One email every Friday on AI velocity, codebase excellence, and the future of product-grade engineering. No noise. Unsubscribe anytime.