Norn is a local-first workspace for advanced pull request reviews on Bitbucket Cloud and GitHub.
This section contains practical guides to installing the project, configuring a repository, following the diff-first review workflow, and using the built-in AI assistants.
Choose your interface
Norn is available in three forms:
- Headless CLI for scripted reviews, AI-agent workflows, CI, and pre-push gates.
- Terminal UI for an interactive review workspace that runs entirely in your terminal.
- Desktop app for visual diff exploration, image previews, local drafts, and explicit publication controls.
All three interfaces follow the same local-first model: review state stays on your machine, and nothing is published until you choose to publish it.
Where to start
Start with the quick start if this is your first time using Norn. If it is already configured, continue with the review workflow or the AI Assist guide.
- Quick start
- Installation
- Choose an interface
- Headless CLI
- Terminal UI
- Desktop app
- Repository configuration
- Providers and credentials
- Policies and analyzers
- Review metrics
- Troubleshooting
You can find the source code and complete project documentation in the delaudio/norn repository.