Documentation

Everything you need to get started with Nightcall.

Installation

Install the Nightcall CLI using your preferred package manager.

Cargo (recommended)

cargo install nightcall

Homebrew

brew install nightcall

Requires Rust 1.75+ for cargo install, or macOS/Linux for Homebrew.

Quick Start

Get from zero to on-call in under 5 minutes.

Authenticate

nightcall auth login

Initialize your team

Create a team and set up your first on-call schedule interactively.

nightcall init

Check who's on call

See the current on-call rotation at a glance.

nightcall who
# Output:
# On-call now: alex (primary), jordan (secondary)
# Rotation: backend-team · Ends in 2d 14h

Manage incidents

Create, acknowledge, and resolve incidents from your terminal.

# Create an incident
nightcall incident create --title "API latency spike" --sev 2

# Acknowledge
nightcall incident ack INC-42

# Resolve
nightcall incident resolve INC-42 --note "Scaled up replicas"

Reference

Full reference documentation for power users.

CLI Reference→

Complete list of all commands, flags, and configuration options.

API Documentation→

REST API endpoints for integrations, webhooks, and automation.

Common Commands

Command	Description
nightcall auth login	Authenticate via OAuth
nightcall init	Initialize team & schedule
nightcall who	Show current on-call
nightcall schedule list	List all schedules
nightcall schedule override	Create a temporary override
nightcall incident list	List open incidents
nightcall incident create	Create a new incident
nightcall incident ack <ID>	Acknowledge an incident
nightcall incident resolve <ID>	Resolve an incident
nightcall agent status	Check AI agent status