singular-machines/provenance

Which agent session opened this PR, and is it still running?
Quick start · Reading the table · Timeline · How it works · Install hooks · Privacy · Roadmap · License
You run Claude Code, Codex, OpenCode and Pi in lots of apps: the terminal, Claude desktop, Codex desktop, T3 Code, Conductor, the web. They all open PRs. On GitHub you can't tell which session opened a PR, or whether that session is still alive.
provenance prs lists your open PRs with the session behind each one: the app it runs in, when it was last active, and whether it's running or waiting for you. provenance go opens that session, and provenance send messages it.
| | Claude Code | Codex | OpenCode | Pi |
| prs: the session behind each PR | Yes | Yes | Yes | Yes |
| Live status | With install | With install | From its database, guessing "waiting" while any opencode runs | With install |
| go: switch to a running terminal session | With install | With install | No: prints the resume command | With install |
| go: resume an ended session | Yes | Yes | Yes | Yes |
| send: message the session | With install; bypass-mode targets only through T3 Code | With install | Not yet | Not yet |
| reply: answer an incoming message | Identified local session | CLI can select the exact shared-process session using its harness IDs | Not supported | Not supported |
For terminal sessions without usable process records, go resumes in the session folder and may start a second copy. Desktop-app sessions use the app or deep-link routes below without requiring install. send refuses when it cannot tell whether the session is running, unless --resume is supplied and the last recorded state allows it; see the messaging policy below.
## Highlights
Works with nothing installed. It reads the session logs Claude Code, Codex and Pi already write, and OpenCode's session database.
Exact matches with stamps. An optional git hook adds Agent-Session trailers to agent commits. Claude Code on the web's Claude-Session trailers are read too.
Live status. Session hooks show whether each session is running, waiting for you, stopped or ended.
Every app. Terminal, Claude desktop, Codex desktop, T3 Code, Conductor and the web.
Fast. Cached repeat runs take well under a second.
Private by default. Commit stamps carry a random machine ID, never your host name.
Terminal only. One Rust binary plus the GitHub CLI. --json for scripts and agents.
## Quick start
sh
cargo install --git https://github.com/singular-machines/provenance
gh auth status # provenance uses your existing gh login
provenance prs # your open PRs and the session behind each
provenance install # optional: exact stamps and live status
## Usage
| Command | What it does |
| provenance prs | Your open PRs across GitHub |
| provenance prs --repo owner/name | One repository |
| provenance prs --author someone | Someone else's PRs |
| provenance prs --state merged | Merged PRs instead (closed or all too; the newest 100) |
| provenance prs --verbose | Also count matches by stamp, repo and folder path |
| provenance prs --json | Every matching session per PR, for scripts and agents |
| provenance prs --refresh | Search GitHub now instead of using the 2-minute cache |