# Rails Hyperdrive

> A development-only Rails engine that gives AI coding agents live answers from your booted app, and lets any gem ship agent skills matched to your Gemfile.

- URL: https://evilmartians.com/opensource/rails-hyperdrive
- GitHub: https://github.com/rails-hyperdrive/rails-hyperdrive
- Authors: Albert Pazderin

---

An AI coding agent working on a Rails app reads source files and guesses at everything else: the resolved routes, the actual schema, the config after all the initializers ran. Rails Hyperdrive mounts an MCP endpoint into the development server, so the agent queries the booted app directly—routes, models, schema, read-only SQL, and Ruby evaluation in the running process.

The second half is distribution. Any gem can ship agent skills and eager guidelines; a `hyperdrive.yml` manifest at the gem root—one line in the simplest case—gates them on the consuming app's Gemfile, so an app only receives guidance for libraries it actually bundles. Content lands during `bundle install`, and `bin/rails hyperdrive:sync` keeps it current afterwards: your local edits are preserved by default, with explicit `--merge`, `--sidecar`, and `--overwrite` strategies for reconciling upstream changes, all tracked in a git-committed lock file.

Companion gems are ordinary gems on RubyGems, discoverable by a metadata declaration—`bin/rails hyperdrive:discover` intersects what's published with your lockfile and suggests what your stack is missing. The engine itself refuses to run outside development: it's a workbench for coding agents, not production machinery.