Quick Start

Get running in 2 minutes.

1. Install

brew install marcus/tap/nightshift

2. Setup

Run the guided setup to configure providers, projects, and budget:

nightshift setup

3. Preview

See what Nightshift will do before it does anything:

nightshift preview
nightshift budget

4. Run

Execute tasks manually (or let the scheduler handle it):

nightshift run

You'll see a preflight summary showing what will run, then a confirmation prompt. Use --dry-run to preview without executing, or --yes to skip the prompt:

nightshift run --dry-run    # Preview only
nightshift run --yes        # Skip confirmation

5. Check Results

Review what happened:

nightshift status --today

Everything lands as a branch or PR. Merge what surprises you, close the rest.