Skip to content

Try SecondShift locally

You’ll run the documentation drift check included in the SecondShift repository, then inspect its report. You need uv, Docker, Git, and a model provider API key or a Claude Code or Codex subscription. Start Docker before continuing.

Terminal window
release=https://github.com/piotrekno1/second-shift/releases
uv tool install --force --python 3.13 \
"$release/download/v0.1.0b8/secondshift-0.1.0b8-py3-none-any.whl"
secondshift up

SecondShift opens your dashboard when it is ready. The first start builds the agent image for subscriptions and takes a few minutes. To skip it, run secondshift up --no-agents. Keep SecondShift running. Press Ctrl+C to stop.

In a second terminal:

Terminal window
git clone https://github.com/piotrekno1/second-shift.git
  1. In Repositories, select Add local repository and choose the cloned directory.
  2. In Models, add an API key and choose a default model, or add a Claude Code or Codex subscription.
  3. Open Documentation drift in Jobs and select Run now.
  4. Open the finished run to see its report, activity, and model cost.

Model usage may incur charges. For local sign-in and upgrade details, see self-hosting. To hand over one-off work, see Tasks. To add your own scheduled job, continue with Add a task.