CLI Reference

Core Commands

Command	Description
nightshift setup	Guided global configuration
nightshift run	Execute scheduled tasks
nightshift preview	Show upcoming runs
nightshift budget	Check token budget status
nightshift task	Browse and run tasks
nightshift doctor	Check environment health
nightshift status	View run history
nightshift logs	Stream or export logs
nightshift stats	Token usage statistics
nightshift daemon	Background scheduler

Preview Options

nightshift preview                # Default view
nightshift preview -n 3           # Next 3 runs
nightshift preview --long         # Detailed view
nightshift preview --explain      # With prompt previews
nightshift preview --plain        # No pager
nightshift preview --json         # JSON output
nightshift preview --write ./dir  # Write prompts to files

Task Commands

nightshift task list              # All tasks
nightshift task list --category pr
nightshift task list --cost low --json
nightshift task show lint-fix
nightshift task show lint-fix --prompt-only
nightshift task run lint-fix --provider claude
nightshift task run lint-fix --provider codex --dry-run

Budget Commands

nightshift budget                 # Current status
nightshift budget --provider claude
nightshift budget snapshot --local-only
nightshift budget history -n 10
nightshift budget calibrate

Global Flags

Flag	Description
--verbose	Verbose output
--dry-run	Simulate without changes
--provider	Select provider (claude, codex)
--project	Target specific project
--task	Run specific task type
--timeout	Execution timeout (default 30m)