Federico Del Gaudio
Norn docs Terminal UI Contents
Back to project
•
2 min read

Terminal UI

Table of Contents

The Norn Terminal UI provides an interactive pull-request review workspace in the terminal.

Norn terminal review workspace with repository, pull request, and AI review panes

Launch modes

From a supported Git repository, run either command:

norn
norn-tui

Norn resolves the current repository from its Git remote and opens its pull requests. To start from the configured repository list instead, use:

norn-tui --workspace

The TUI runs a readiness preflight before opening. Use norn doctor to inspect and resolve failures rather than routinely skipping the preflight.

Main workflow

The interface is divided into repository, pull-request, and detail areas. The detail view can show pull-request information, AI review output, or the diff.

Common keys:

  • j / k or arrow keys: move through the active list;
  • Tab: move focus between panes;
  • Enter: open the selected pull request;
  • g: open or close the diff view;
  • u: switch between unified and side-by-side diffs;
  • i: switch the image side for supported image changes;
  • v: toggle pull-request and AI-review detail;
  • a: start an AI review;
  • y: copy AI review output;
  • c: compose a local comment draft;
  • p: publish drafts;
  • x: discard drafts;
  • f: cycle the pull-request filter;
  • r: refresh the active view;
  • s: open AI provider settings;
  • q or Esc: quit.

AI settings

The settings screen lets you select Claude or Codex and choose the model and reasoning effort used by TUI reviews. Use j / k to select a setting, arrow keys to change it, Enter to save, and Esc to cancel.

Credentials

The TUI resolves provider credentials from the OS keychain first, then from environment-variable references in ~/.config/norn/config.toml, and finally from the standard provider environment variables.