Skip to main content
Nightshift is currently in its infancy and is subject to change and incompleteness. If you find a bug, or have an idea to improve Nightshift, please raise an issue on Github and join our slack for updates.

​
Install the toolchain

After building or installing Nightshift, prepare the agent and it’s environment with: 
nightshift install --prefix ~/.demo
This downloads and installs:
  • OpenCode (and soon Claude Code, Gemini CLI, and Codex see Contributing to help us out)
  • uv (Python toolchain manager)
  • ripgrep
  • bwrap (if you’re on linux)

​
Launch the Agent

​
Run Nightshift

nightshift run
This will default to the last ran or installed prefix. To change the prefix you want Nightshift to run you can pass the --prefix flag:

​
Running Nightshift with Prefix

nightshift run --prefix ~/.demo
Currently, Nightshift will default to running Opencode as the Agent Harness. We’d like to add support for other Agent harnesses in the future. You have the option to run the Nightshift TUI which will eventually be a simplified version of the Opencode TUI used for our customers (who are not technical). The Nightshift TUI is still a work in progress.

​
Running the Nightshift TUI

nightshift run --run-nightshift-tui
Nightshift