Getting Started
The fastest path from a fresh install to your first shipped feature on Jorv Builder. About 10 minutes if you already have an Anthropic API key.
1. Install Jorv Builder
Download the latest build from the Releases page. Jorv Builder ships for both macOS and Windows.
- macOS: Open the
.dmg, drag Jorv Builder into Applications. - Windows: Run the
.exeinstaller.
2. Add your API keys (BYOK)
Jorv never proxies your AI provider calls — you bring your own keys. The first launch will prompt you to add at least an Anthropic key.
Required:
- Anthropic — powers the Brain. Get a key at console.anthropic.com.
Optional (configure when needed):
- OpenAI — for Whisper STT and OpenAI TTS. See /docs/voice.
- ElevenLabs — for premium TTS voices.
- Gemini / OpenAI — for drone workloads and media generation.
See BYOK setup for the full guide.
3. Open a project
File → Open Project… and pick a local directory. Jorv Builder doesn’t copy or upload your code — it stays where it is, Jorv Builder just reads it from disk.
The first time you open a project, Jorv Builder will look for PRODUCT.md and ARCHITECTURE.md. If they’re missing, Jorv Builder will offer to scaffold them based on what it sees. These two files are the contract — the source of truth the Brain builds against. See ORBIT methodology.
4. Run your first brainstorm
Hit ⌘B (Mac) / Ctrl+B (Windows) to open the Brainstorm panel. Type a request:
"Add an OAuth flow for GitHub sign-in."
The Brain will:
- Read the relevant parts of your codebase
- Propose 2-4 approaches with tradeoffs
- Surface risks (existing patterns to respect, dependencies, security)
- Recommend one and ask you to confirm
You can ask follow-ups, refine the recommendation, or pick a different approach. Nothing is written yet — this is the spec stage.
5. Approve the build
Once you’re happy with the proposed plan, click Build (or hit ⌘↩). The Brain executes the plan in your project — writes code, runs tests, fixes issues. You watch it work; you can pause or steer at any point.
6. Audit (optional but recommended)
When the build is done, run an Expert Audit — pick a domain (Security, Performance, A11y, etc.) and the Brain runs a single-pass Sonnet review. Findings land in the Compliance Center.
7. Commit + push
Jorv Builder writes changes to your working tree, never to a remote. Review the diff in the Diff View tab, then commit via the integrated git tools or your usual workflow.
What to read next
- BYOK setup — configure your AI providers
- ORBIT methodology — the philosophy underneath
- Brainstorm first — why every feature starts with a brainstorm
- Compliance Center — Article 12-ready audit posture