nightshift/docs/troubleshooting.md

Troubleshooting

command is not allowlisted

Add the exact command to safety.allowed_commands. NightShift normalizes whitespace but otherwise expects exact matches.

Command works in PowerShell but fails in NightShift

Command stages use Python subprocess execution. By default shell: true uses the platform shell, which is usually cmd.exe on Windows. Prefer Python module commands or set explicit shell commands.

No runnable tasks

Check nightshift status. A task may be blocked by dependencies listed under Dependencies:.

Git clean worktree failure

If require_clean_worktree: true, NightShift blocks dirty repositories before creating artifacts. Commit/stash changes or set it to false.

Ollama backend fails

The ollama backend requires the ollama executable to be installed and the configured model to be available. Tests do not require Ollama.

Flask dashboard fails

Install Flask:

pip install flask