Repository navigation
Troubleshooting
Each entry says what you see, why, and how to fix it.
When a run fails or ends early, start here:
- Open the run.
- Choose Ask why. An agent reads the run, and tells you what went wrong and what you can do. It changes nothing.
- Open the step that failed. Its transcript shows what the agent or the command did.
When the editor shows a problem, open Issues at the bottom of the canvas. It lists the errors and the warnings of the flow. Fix the errors before you run the flow.
The step ended on an outcome without an edge. An outcome without an edge ends the run there. The editor warns about it under Issues. Connect the outcome to the next node, or add an End node to it with a clear message.
A template names the node by its id, not by its title. Check the id of the node in the panel on the right, and check the field name. For example, {{planner.data.taks}} has a typo. See Data between nodes.
A schedule cannot start a flow with errors. Open the flow, and fix each error under Issues.
The macOS app is not signed yet. Open System Settings > Privacy & Security, and choose Open Anyway. Later updates install without this step.
Your harnesses in Settings has no Set up an agent, or the page of an agent says where to set it up. Night Shift installs an agent only on the computer that runs it.
- "Open Night Shift on that computer to set up an agent there." You use Night Shift from another computer. Open Night Shift on the computer that runs the agent.
- "Night Shift runs in a container here, so an install would not last." Add the agent to the image of your Host. See Add your tools.
- "Night Shift can set up an agent on macOS and Linux only." Install the agent yourself. Then add it in Settings, under Your harnesses.
Open Details under the problem. It shows the last messages of the installer. Check the internet connection of this computer, then choose Install again.
The problem says that the agent installed, but Night Shift cannot find it. Quit Night Shift and open it again. Then choose Sign in.
The setup says that the agent is not signed in yet, or that the sign-in took too long. Choose Sign in again, and finish the sign-in in your browser. If the page shows a code, paste it in the Code field. Cancel stops a sign-in that waits.
- "Ollama did not start." Open the Ollama app, or start Ollama yourself. Then choose Use Local again.
- "The download of llama3.2:latest stopped." Check the internet connection of this computer. Then choose Use Local again. The download continues from where it stopped.
- "Night Shift could not install Ollama." Open Details under the problem for the last messages of Homebrew. Or download Ollama from its page, then choose Check again.
A Decision or a Value runs on an Ollama model that this computer does not have. Open the Model Profile of the step in Settings, under Models, and choose Download. Then run the step again.
Night Shift needs pi 0.81 or later. Update pi.
The flow names a custom agent that this computer does not have. Add it under Agents, or pick another agent on the node.
Its profile is in Accept edits or Ask for each tool mode. Those modes cannot run shell commands when nobody approves them. The flow editor warns about it. Set the profile to Auto. See Permission modes.
You need to do nothing. The step waits for the reset, and continues the same session. See Run policy.
The node names a profile on that computer, and it has no backup that can take the step. Start the computer, or add a backup on another computer. Without either, the step waits until the stop time.
A step on a Host never reads a Personal secret, also on your own Host. Move the secret to the Space or the project on the Secrets page. See Secrets.
The flow names a computer that left the Space. Open the node, and choose another profile or computer.
Another install of the same computer is online. One computer is one Device, and only one Night Shift at a time can be that Device. Quit the other install, then pair again.
The computer or the Host runs an older version of Night Shift. It cannot add a project without a folder, or run the steps of one. Update Night Shift there.
The End node reads its report from a file, but it did not get a text file from that path. The run page says why. Check these:
- The step writes the file inside the folder the run works in. The End node uses the same path, for example
reports/{{topic}}.md. - The file is text, such as Markdown. Night Shift does not read a PDF or an image as a report.
- In a project without a folder, the step that writes the file runs on the same computer as the run. Each computer has its own folder of the run.
- The computer with the file stays on until the run ends. "Could not read the report file on" a computer means that it was offline or did not answer. Night Shift waited for it as long as the Network limit of the run policy.
"Update Night Shift" in the message means that the computer runs an older version. Update Night Shift there.
The computer that keeps this Space runs an older version of Night Shift. It cannot run a test with pinned outputs or skipped nodes, so nothing starts. Update Night Shift on that computer. Or start the run without pins and skips.
A test run also moves only to a computer that can run one. A move to a computer with an older version says "runs an older version of Night Shift".
Night Shift starts a missed time only within the schedule's late window. The default is 15 minutes. If the Host was off for longer, Night Shift skipped the time and told you. Make the late window longer, or keep the Host on.
A schedule's run starts on the Host, so the Host needs the project. A Host copies a project with a GitHub remote by itself. A project without a folder needs no copy. A private repository needs gh signed in on the Host. See The Host copies your GitHub projects.
Search by meaning needs Ollama and its model. The Knowledge page tells you when search by meaning stopped. Start Ollama, or open Settings → Night Shift's agents and click Download in the Search table. See Search.
A clone does not put nightshift on your PATH. Run bun <clone>/apps/server/src/cli.ts, or make an alias. See Terminal and MCP.
By design, a development install (bun run dev) pairs and connects only with a Host on the same computer. To test against a remote Host, set NIGHTSHIFT_DEV_LINK_HOST=true.
Open an issue. Tell what you did, what you saw, and the version of Night Shift.
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