CLI agents
Point it at the coding agents already installed in your PATH. Detected automatically — just press Use.
claudecodexgemini
Forge a vague idea into a build-ready spec.
Hephaestus interviews you about your idea and forges a PRD, technical spec and honest estimation — with the AI engine you already have.
No data leaves your machine
Engines detected from your PATH
MIT licensed
$git clone https://github.com/r10d1nsec/hephaestus-forge
$cd hephaestus-forge && ./run.sh
✓http://localhost:3000 — engines detected from your PATH
Bring Your Own Engine
Run it on the AI you already pay for.
No vendor lock-in, no new subscription. Hephaestus plugs into the engine sitting on your machine or in your existing account.
API providers
Bring a key from any OpenAI-compatible provider. Your credentials stay in your local config.
OpenAIAnthropicOpenRouter
Local models
Run fully offline with Ollama or any local server. Nothing ever leaves the machine.
OllamaLM Studiollama.cpp
How it works
Five phases from sentence to spec.
A guided wizard turns one line of intent into documents a build agent can act on.
01
Describe
Start with a sentence or a short paragraph. That's all Hephaestus needs to begin.
02
Interview
It asks the sharp questions — scope, users, constraints — and fills the gaps you'd have missed.
03
Blueprint
Get a recommended solution type, realistic scale, and an honest time estimate before you commit.
04
Specify
A full PRD and technical spec are forged — structured, opinionated, and build-ready.
05
Ship
Export a ZIP and hand it straight to your build agent, or keep iterating with Regenerate.
See it work
Documents, not chat transcripts.
Every project produces a tidy, navigable workspace — Blueprint, PRD, Technical Spec and Estimation, ready to export.
Examples
Real specs, forged end to end.
Two sample projects ship with the repo so you can see the output before running your own.
Documentation
Everything you need to self-host.
Clear, practical guides — from first clone to plugging in your own engine.
Quickstart
Clone, run, forge your first spec in minutes.
Bring Your Own Engine
Wire up CLI agents, API keys or local models.
The 5-phase wizard
How an idea becomes a build-ready spec.
Self-hosting
Run it on your machine, fully offline.
Document types
Blueprint, PRD, Technical Spec, Estimation.
Contributing
Add engines, translations and templates.
Forge with us.
Hephaestus is open source and 100% local. Bring your own engine, bring your own ideas — and help shape the anvil.
