Repository navigation
Home
Night Shift runs your AI agents for you. You draw once how a job goes: which agent does each step, and where you want to decide. Night Shift then runs the job on your own computers, day and night, and asks you only what needs you.
Night Shift works like n8n or Zapier, but a step can be an agent that works for an hour.
This wiki is the user guide.
New to Night Shift? Read these pages in this order:
- Get started. Install the app, connect an agent, and run your first flow. About 15 minutes.
- How Night Shift works. The main words: project, flow, node, run, Gate, schedule.
- Your first flow. Build a flow that writes a news brief each morning. About 15 minutes.
| Page | Read it to |
|---|---|
| Runs and schedules | Start a run, schedule a flow, start a flow from a webhook, and resume a run. Read Home, Flow health, and Spend. |
| Gates and the inbox | Answer what waits for you, and choose when your phone tells you. |
| Knowledge | Give your agents notes, web pages, and documents to read. |
| Community flows | Import a flow that another person made, or share yours. |
| Ideas | Find a flow that nobody has built yet. |
| Phone app | Answer Gates and follow your runs from your phone. |
| Troubleshooting | Find what a message means, and how to fix it. |
| Page | What is in it |
|---|---|
| Flows and nodes | Every node type, templates, data shapes, the editor, kits, and the starter flows. |
| Agents and profiles | The agents that Night Shift runs, profiles, CLI tools, and connections. |
| Computers and Hosts | Join your computers with a Host. Spaces, Offers, and secrets. |
| Terminal and MCP | The nightshift command, and the MCP tools for an agent in a terminal. |
Night Shift is pre-alpha. It changes fast. Expect breaking changes to the flow format and the database.
Night Shift has run a real project every night since 2026-10-16.
The repository holds the docs for people who build or run Night Shift:
- Run a Host on a server, and reach it over your LAN, Tailscale, a public server, or a tunnel.
- Start a flow from another tool with a signed webhook.
- The plan, the glossary, and the architecture decisions.
- Contributing and security.
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