Skip to content

Repository files navigation

claude-oss

Run an open-source repo as its maintainer. Triage the tracker, delegate the work, review hard, merge on green.

Version Python OS License


The problem

A maintainer loop written as prose gets copied between repos, and the copies drift. Fixing a triage rule means editing it in three places and remembering the third. Repos that never got the copy run no loop at all.

This packages the loop once: one skill, two agents, a handful of commands. Everything that differs between repos — default branch, label spellings, version sites, test command — lives in a config file the plugin writes by probing the repo, not in the prose.

Install

/plugin marketplace add Digital-Process-Tools/claude-marketplace
/plugin install oss@dpt-plugins

Restart Claude Code afterwards. Plugin registrations are read once at session start.

Installing pulls in supertool, remember and claude-jit-context automatically — they are declared dependencies and resolve from the same marketplace.

After cloning a repo you maintain

cd the-repo
oss-workspace

That opens a session over the repo you are standing in, with the maintainer loop already running — or with /oss:setup if the repo has no .oss.json yet, because a tick against guessed values merges into the wrong place confidently.

It does not set up a board. The session is started able to receive watch-channel events, but radar reads its tiers from that repo's own .supertool.json, and a fresh clone has none. The launcher says which of the two is missing rather than reporting the session as armed — a channel nobody publishes to looks exactly like a quiet board.

Install the launcher once:

ln -sf "$PWD/bin/oss-workspace" ~/.local/bin/oss-workspace

The working directory is the selection: it opens that repo, never this plugin's checkout.

Commands

Command What it does
/oss:tick One pass of the maintainer loop: board, decide, delegate, review, merge on green.
/oss:setup Probes the repo and writes .oss.json. Measures; never assumes.
/oss:scaffold Adds the missing repo furniture. Never overwrites; shows before it writes.
/oss:triage One triage sweep — priority, lane, milestone, and what the board is lying about.
/oss:changelog Checks changelog fragments, or folds them for a release.
/oss:doctor Config, dependencies, clone, worktree root, state file. Exits 0 always.

Status

Not yet run against a live repo. The loop, both agents, the config layer and the diagnostic are in and tested; what has not happened is a real issue taken from triage through to a merge. Until that round-trip is clean twice, treat this as unproven rather than working.

Development

python3 -m pytest tests/ -q

CI runs the suite on ubuntu, macOS and Windows across Python 3.9-3.12. A green macOS run is not evidence on its own.

License

Community License — see LICENSE. Source-available, not open source: no commercial redistribution, no competing use.

Built by Digital Process Tools in Toulouse, France.

About

Run an open-source repo as its maintainer: triage the tracker, delegate the work, review hard, merge on green. One loop, one version, and per-repo differences in config instead of prose.

Topics

Resources

Code of conduct

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages