CLI

The Norn CLI is a Charm-powered terminal client built with Bubble Tea, Lip Gloss, and Cobra. It provides rich TUI rendering for deploy progress, log streaming, and app status.

Installation

cd norn/v2
make build     # builds bin/norn
make install   # copies to ~/go/bin/norn

Configuration

The CLI needs to know where the Norn API is running:

Variable	Default	Description
NORN_URL	http://localhost:8800	API base URL

Or use the --api flag on any command:

norn --api=https://norn.example.com status

Quick Reference

Command	Description
norn status	List all apps with health and status
norn app	Detailed view of a single app
norn deploy	Deploy with live pipeline progress
norn preflight	Rehearse build/test without runtime mutation
norn operations	Inspect durable operation rows and drain state
norn resources	Resource usage and right-sizing suggestions
norn notifications	Manage Beacon notification channels
norn canary	Inspect and promote canary deployments
norn deploy-groups	Run ordered multi-app deploy groups
norn restart	Rolling restart
norn rollback	Rollback to previous deployment
norn scale	Scale a task group
norn logs	Stream live logs
norn health	Check backing service health
norn stats	Deployment and cluster statistics
norn access	Access events and temporary IP grants
norn secrets	Manage app secrets
norn snapshots	Database snapshot management
norn services	Service manifest and reachability
norn cron	Cron job management
norn invoke	Invoke a function
norn saga	View saga event log
norn validate	Validate infraspec files
norn forge	Set up cloudflared routing
norn teardown	Remove cloudflared routing
norn version	Version and API endpoint info

Version

$ norn version
norn v2 abc1234
api: http://localhost:8800