AI Assist

Norn integrates Claude and Codex into the review workflow without turning them into automatic publishers. The assistant proposes; the reviewer decides what to keep and what to publish.

How it works

• A run starts with the context of the current repository, pull request, and diff.
• Norn stores review results, findings, and evidence locally.
• Proposed comments remain drafts until you explicitly choose to publish them.
• You can configure the provider and model options for the review workflow.

Norn launches the provider’s locally installed CLI. Authenticate claude or codex before starting a review, and use norn doctor --machine-only to check that the selected executable is available.

Reviews from the terminal

Select Codex explicitly:

norn review --repo-path . --scope working-tree --ai-provider codex

Or use Claude:

norn review --repo-path . --scope working-tree --ai-provider claude

You can request structured output for automation and integrations:

norn review --repo-path . --scope branch --format json --fail-on-findings

Use --model and --effort for one-run overrides, or configure defaults in the desktop app and TUI settings.

Privacy and control

An AI review sends the constructed review context to the selected provider. Norn keeps credentials outside repository config and never publishes model output automatically. Review every finding and draft before publication.

Headless mode returns findings only. Desktop and TUI workflows let you turn accepted findings into local drafts and explicitly publish them.

When to use it

AI Assist is useful for navigating large pull requests, identifying risks, and getting an initial reading of unfamiliar code. It does not replace reviewer judgment: always verify every finding against the diff and the system’s actual behavior.