Your code gets better while you sleep.

---

What is this?

Nightshift is a helper that works at night.

It wakes up your coding agent. It gives the agent one small job. The agent looks at your code and does the job. If it finds something worth fixing, it opens a pull request for you to look at. Then it moves to the next job.

In the morning, you read what it did. Many nights it finds nothing. That is fine. Nothing is better than a bad change.

Every two hours, it also reads any open pull requests and leaves a short review.

The jobs

Every job follows the same rules. They are in jobs/_common.md. In short:

• Read the repo's own guide files first. They win.
• Read what the owner said on past pull requests. Learn their taste.
• Never touch a file that someone else's open pull request touches.
• Run the repo's checks. Fix what breaks.
• Open a pull request, or say why not. Never push to the main branch.

Watch it

Nightshift comes with a console. It shows every night and every job on one screen, and it lets you pick up any night's conversation where the agent left off. Tell your coding agent:

Open the Nightshift console. Read ~/nightshift/tui/README.md and start it.

It needs Node. Press c on a job to talk to the agent about what it did. Press ? for the rest.

How to start

Tell your coding agent this:

Get github.com/openslop/nightshift and set it up for my code at ~/code/my-app. Read SETUP.md there and follow it.

That is it. Your agent will ask you a few questions, set two timers on your computer, and show you where the notes go.

Works on Mac, Linux, and Windows. Works with Claude Code, Codex, Cursor, Gemini, Copilot, Hermes, OpenClaw, and most other coding agents. The full list is in nightshift.conf.example.

What is inside

• jobs/ has one page per job, in plain English. Read them. Change them if you want.
• jobs/_common.md has the rules every job follows.
• review/SKILL.md says how the reviewer acts.
• nightshift.conf.example is the settings page. Your agent fills in a copy.
• SETUP.md is the page your agent follows to set things up.
• bin/ has three small scripts the timers run. You do not need to read them.
• tui/ is the console. tui/README.md says how to open it.

Is it safe?

• It only ever opens pull requests. You decide what gets merged.
• It never touches a file that another open pull request touches.
• It runs your checks before it opens anything.
• It runs once a night. If your computer was asleep, it skips that night instead of running in the middle of your day.
• Everything it does is written to a log on your computer, outside your repo.

Change it

• Turn a job off by taking its name out of the JOBS line in your settings.
• Change how a job thinks by editing its page in jobs/. Keep the words plain.
• Add a job by adding a new page in jobs/ and putting its name in JOBS.
• Use a different agent by picking a different AGENT line in your settings.

Turn it off

Tell your agent: "Turn off Nightshift." It removes the two timers. Your code is not touched.

License

MIT. Free to use, copy, and change.