Know the repository
A persistent repository identity and exact physical-folder binding distinguish similar checkouts.
LOCAL CLI · BOUNDED V1
One trusted NEXT handoff for each repository. Check where you are, read the task, and replace it deliberately when the work changes.
For people working across projects, branches and AI sessions.
Git-only quickstart · View on GitHub
rc.1 is a prerelease, not a stable release and not Latest.
CONTEXT BEFORE ACTION
A persistent repository identity and exact physical-folder binding distinguish similar checkouts.
Branch and authoritative revision checks catch a stale handoff when the work has moved on.
Lane, model label, action identity and prompt checks protect the handoff. A replacement requires the previous NEXT digest.
The model label is declared context; Overseer does not verify which AI model is running or judge the task’s quality.
THE EVERYDAY FLOW
Choose Git or Muse explicitly. Bind the checkout’s physical folder and repository identity.
initRead the repository, branch, revision, lane, model label and NEXT status.
statusValidate the handoff before copying it into your work session. Overseer does not run it.
nextChoose the next task yourself. Supply its context and the previous NEXT digest to publish it.
next-writeStart with the Git-only quickstart for complete commands and the values to supply.
YOUR REPOSITORY, YOUR CHOICE
Permanently supported. No Muse installation, no Muse account and no migration requirement.
Explicitly initialize or adopt Muse authority for a repository. Freshness follows its Muse branch and revision.
Prepare and verify a controlled projection. Explicit delivery can push the verified mirror and create its pull request; it never merges it.
A local command-line tool. No hosted service, desktop product, background process, telemetry, automatic updater, registry or OCI system.
Overseer does not run prompts, choose the next task, merge automatically, release automatically or deploy automatically. Hooks are optional and off by default.
It protects against stale context and ordinary mistakes on a trusted host. It is not a boundary against a malicious administrator.
START WITH ONE REPOSITORY
Install the checksum-verified prerelease source at a fixed physical path, then initialize a repository you are authorized to manage.