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 has three interfaces:
- 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. It is currently built from source.
The stable Homebrew formula includes the CLI, Terminal UI, and managed review skill assets for Codex and Claude Code on Apple Silicon and Intel Macs. The desktop app is not currently published as a Homebrew cask. 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
- Agent skills
- Policies and analyzers
- Review metrics
- Troubleshooting
You can find the source code and complete project documentation in the delaudio/norn repository.