This project is immature. We are not yet in a position to guarantee that future versions will be compatible with data generated by earlier versions. Please use for experimentation only.
Brunch is an AI-guided spec elicitation tool that turns a rough project idea into a structured specification through a multi-phase interview. It runs locally, keeps workspace state in a project-scoped SQLite database, and opens a browser UI for working through grounding, design, requirements, and acceptance criteria.
Brunch requires Node 22+ and an Anthropic API key.
Create a .env file in the project directory where you want to use Brunch:
echo "ANTHROPIC_API_KEY=sk-ant-..." > .envThen launch it in that directory:
npx @hashintel/brunchBrunch will create or reuse the local .brunch/ workspace for that project, start the web UI, and open it in your browser.
If you prefer a global install:
npm install -g @hashintel/brunch
brunch| Variable | Required | Description |
|---|---|---|
ANTHROPIC_API_KEY |
Yes | Anthropic API key |
ANTHROPIC_MODEL |
No | Interviewer model override |
OBSERVER_MODEL |
No | Observer model override |
BRUNCH_PORT |
No | Port for the local web server |
npx @hashintel/brunch --helpDevelopment setup, architecture notes, fixture workflows, release steps, and internal planning docs live in CONTRIBUTING.md.