// readme

SecondShift

Give recurring engineering work a shift.

Commit an agent skill next to your code. SecondShift runs it in a sandbox, with only the access your team approved, and keeps its results and cost.

Open source, self-hosted, and in beta. Bring your own model provider.

Quick start · Skill catalog · Docs · Website

https://github.com/user-attachments/assets/0a9a7baa-f79e-4934-af81-8e5374e9cdbf

How it works

Define a job in .secondshift.yaml. This example runs a skill every Monday:

jobs:
  engineering-briefing:
    name: Monday engineering briefing
    skill: examples/engineering-briefing/.agents/skills/engineering-briefing/SKILL.md
    schedule: "0 9 * * 1"
    requires:
      mcps:
        - binding: github
          tools:
            - search_pull_requests
            - list_commits
    notify:
      - binding: engineering-reports
  1. Write the skill with Claude Code, Codex, or any coding agent. Merge it through your normal review.
  2. Approve its access in the dashboard. A…