Skip to main content

It finds what you forgot to look for.

AI-powered overnight maintenance for your codebase. Uses your remaining token budget to find dead code, doc drift, test gaps, security issues, and 20+ other things silently accumulating while you ship features.

$ brew install marcus/tap/nightshift

Open source ยท MIT License

nightshift preview
$ nightshift preview

Nightshift v0.9.0
Budget: 68% remaining (daily mode)
Provider: claude (subscription)

Next run: 3 tasks across 2 projects

~/code/sidecar
โœ“ lint-fix (low cost, 24h cooldown)
โœ“ dead-code (medium cost, 72h cooldown)

~/code/td
โœ“ docs-backfill (medium cost, 168h cooldown)

Estimated budget usage: ~32%

Like a Roomba for your codebase

๐Ÿ”‹

Budget-Aware

Uses remaining daily allotment. Never exceeds your configured max โ€” default 75%.

๐Ÿ“

Multi-Project

Point it at your repos. It already knows what to look for in each one.

๐Ÿ›ก๏ธ

Zero Risk

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

โšก

20+ Built-in Tasks

Linting, dead code, doc drift, security, test gaps, and more โ€” ready to go.

๐Ÿ”ง

Great DX

Thoughtful CLI defaults with clear output, reports, and morning summaries.

๐Ÿค–

Multi-Agent

Works with Claude Code and Codex. Uses whichever has budget remaining.

How it works

nightshift.yml

Configure

Point it at your repos. Set a budget cap and schedule.

2:00 AM

Sleep

At 2 AM, nightshift picks up your remaining tokens and gets to work.

3 PRs ready

Wake up

Morning summary waiting in your terminal โ€” branches, PRs, and findings.

git merge

Review

Merge what surprised you. Close the rest. Nothing changes without you.

Works with your agents

Uses the CLI tools you already have installed

Claude Code
Codex
CLI-firstGo binaryZero config defaultsHomebrewYAML configCron schedulingSQLite statePR-based outputBudget calibrationSubscription billingAPI billingCustom tasksTask cooldownsMulti-providerDry-run modeMorning summariesStructured logsmacOS & Linux

Get started in seconds

$ brew install marcus/tap/nightshift