Repository navigation
Get started
| Way | For |
|---|---|
| The desktop app | Your own computer. Download it from the nightly release: macOS (Apple silicon) or Linux (x64). It updates itself. |
| The Docker image | A Host on a server: ghcr.io/xiduzo/nightshift:nightly. See Computers and Hosts. |
| From source | Work on Night Shift itself, or run nights from a clone. See below. |
Every way needs git, and at least one coding-agent CLI that you are logged in to, such as claude. Night Shift runs on macOS and Linux.
The macOS app is not signed yet. The first time you open it:
- Open System Settings > Privacy & Security.
- Choose Open Anyway.
Later updates install without this step. The app downloads an update in the background. It never restarts by itself, because a restart stops the runs in progress. Choose Restart to Install in the app menu when no run needs it.
You need Bun 1.3.
git clone https://github.com/xiduzo/nightshift.git
cd nightshift
bun install
bun run devThe web UI opens on http://localhost:3001. The API runs on port 3000. You need no .env file to start.
| Command | Use it to |
|---|---|
bun run dev |
Work on Night Shift itself, with hot reload. It also starts the phone app in Expo. Data stays in .nightshift-dev/. |
bun run night |
Run real nights from a stable build that does not reload. Data stays in the OS app data folder. |
bun run dev:desktop |
Start the desktop app. |
bun run build:desktop |
Build the desktop app. The installers go to apps/desktop/artifacts/. |
The OS app data folder is ~/Library/Application Support/Night Shift on macOS. On Linux it is $XDG_DATA_HOME/nightshift, else ~/.local/share/nightshift.
Run nights with bun run night, and change Night Shift in a separate git worktree. A code change then never reloads Night Shift in the middle of a night.
-
Add your agents. The Agents page shows the agent CLIs (
claude,codex,opencode,pi) and tools (gh,acli) that it finds on this computer. Choose Add profile or Add tool for each one you want. See Agents and profiles. - Add a project. Choose its folder, or copy a repository from GitHub. Leave Add the starter flows checked. Then choose which of your agents runs each part of the starter flows. Night Shift keeps the flows outside your repository.
-
Start
implement-and-checkwith a small task. As the check, give your project's test command, for examplenpm testorpytest. - Watch the run. Each step shows its transcript live.
When the run works, schedule it for the night. See Runs and schedules.
A released build of Night Shift (the desktop app and the Docker image) sends anonymous usage events to the Night Shift team. A run from source sends nothing. The events are a closed list, with no names, paths, prompts, or code.
To turn usage off, do one of these:
- Turn it off in Settings.
- Set
NIGHTSHIFT_USAGE=offorDO_NOT_TRACK=1.
Usage data lists every event and field.
This wiki comes from docs/wiki/ in the repository. To change a page, open a pull request there. An edit made here is lost at the next publish.
Start here
Use Night Shift
Reference
Repository