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.
Install and start
Section titled “Install and start”release=https://github.com/piotrekno1/second-shift/releasesuv tool install --force --python 3.13 \ "$release/download/v0.1.0b8/secondshift-0.1.0b8-py3-none-any.whl"secondshift upSecondShift 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.
Get the example repository
Section titled “Get the example repository”In a second terminal:
git clone https://github.com/piotrekno1/second-shift.gitRun the check
Section titled “Run the check”- In Repositories, select Add local repository and choose the cloned directory.
- In Models, add an API key and choose a default model, or add a Claude Code or Codex subscription.
- Open Documentation drift in Jobs and select Run now.
- 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.