Manage incidents, services, alerts, runbooks, agents, SLOs, and approvals from the command line. Same auth as the web UI; same data, same permissions. Made for SREs who'd rather type than click.
Install
# From npm (recommended)
npm install -g @novaaiops/cli
# Or build from source
git clone https://github.com/Samsontanimawo/nova-cli.git
cd nova-cli
npm install && npm link
Verify with nova --version (should print 1.5.0).
Quick start
# Authenticate with Nova AI Ops
nova login
# Check platform health
nova status
# List open incidents
nova incidents list --status open
# Acknowledge a page
nova incidents ack INC-42
# Resolve with a note
nova incidents resolve INC-42 --note "Fixed connection pool"
Command reference
Auth + status
nova loginAuthenticate with Nova AI Ops
nova logoutClear stored credentials
nova whoamiShow the currently authenticated user
nova statusPlatform health overview
nova configShow CLI configuration paths
nova openOpen the web UI in your browser
Incidents
nova incidents listList all incidents (filter with --status, --json)
nova incidents create -t TITLE -s SEVCreate an incident
nova incidents ack INC-42Acknowledge a paged incident
nova incidents resolve INC-42 --note "..."Resolve with a note
Services + Health
nova services listList all tracked services
nova services health [name]Health snapshot, all or one service
nova service-mapRender the dependency graph as a tree
nova golden-signalsLatency / traffic / errors / saturation
nova healthOne-screen platform health overview
nova trends uptimeRolling uptime trend
Alerts + SLOs + Runbooks
nova alerts list --firingList firing alerts
nova slo checkSLO posture across all services
nova runbooks listList runbooks (filter by --service)
nova runbooks run RB-01 --target HOSTExecute a runbook on a target
nova runbooks run RB-01 --dry-runPreview without executing
Agents + Approvals
nova agent statusShow all agents and their trust scores
nova approvals listPending high-risk action approvals
nova approvals approve <id>Approve a queued action
nova approvals reject <id> -r "..."Reject with a reason
Security
nova security eventsRecent security events (last 50)
nova security stats24h summary by type/severity
nova security block 1.2.3.4 -r "..."Block an IP with a reason
nova security unblock 1.2.3.4Unblock an IP
Search + Misc
nova search "checkout latency"Search incidents, runbooks, services
nova metrics query "cpu > 80" --last 1hQuery metrics from the CLI
nova drill listList available chaos / automation drills
nova outbox statsEmail outbox counts per status (admin)
Why a CLI
SREs live in terminals. The CLI is the canonical interface for incident response automation, CI/CD pipelines, and on-call workflows that don't tolerate point-and-click. Every Nova UI surface is reachable from the CLI, and every CLI command supports --json for machine-readable output.
