Installation

Headless CLI and Terminal UI

Install the command-line tools with Homebrew on macOS:

brew tap delaudio/tap
brew install norn

The formula installs the norn CLI and the norn-tui terminal interface.

The CLI provides headless commands such as norn review; running norn without a subcommand opens the Terminal UI.

Machine setup

Inspect the proposed machine-level setup without changing anything:

norn setup --dry-run

Run the setup flow and then verify machine prerequisites:

norn setup --yes
norn doctor --machine-only

Setup detects the installed Claude and Codex CLIs and available credential sources. It stores only non-secret local preferences.

Desktop app

When a packaged desktop release is available in the tap, install the native app with the Homebrew cask:

brew install --cask norn

The desktop app provides the full visual workspace. To run it directly from source:

git clone https://github.com/delaudio/norn.git
cd norn
pnpm install
pnpm tauri dev

A locally installed source build can also be launched with norn-app.

Repository setup

Enter a Git repository and start the quick onboarding flow:

cd /path/to/repo
norn init --quick --repo-path . --yes

Norn stores review policies and settings in .norn.yaml. Check that the environment and configuration are ready:

norn doctor --repo-path .
norn config validate --repo-path .

First review

To review uncommitted changes:

norn review --repo-path . --scope working-tree

To review the current branch against its destination branch:

norn review --repo-path . --scope branch

Terminal interface

Run norn without a subcommand to open the TUI in the current repository. You can also launch it explicitly:

norn-tui

Use workspace mode to choose a repository when you are not inside a supported checkout:

norn-tui --workspace