diff --git a/README.md b/README.md index b9db8d4..443c67a 100644 --- a/README.md +++ b/README.md @@ -1,83 +1,50 @@ -
research-git
- A new Git tool for ambitious researchers and developers in the agentic era.
+ Reapply or remove previous experiments & features safely on today’s code.
Works with Claude Code, Codex, Gemini CLI, and opencode.
-
+
+
+
+
+
+
+
+
+
+
+
+ Figure 1. Capturing code changes into the Capsule graph.
+
+
+
+ Figure 2. Recalling Capsules and recording new variants.
+
| Field | +What it holds | +
|---|---|
| intent | +Why this change existed: the hypothesis, not a restatement of the diff. | +
| code slices | +The relevant snippets, files, and symbols. | +
| knobs | +The parameters, flags, and configuration. | +
| dependencies | +The other Capsules it needs, including silent assumptions. | +
| result | +The metrics, notes, and reasons it worked or did not work, linked to the runs it produced. | +
| resurrection guide | +How to regenerate it onto a changed codebase. | +
| Command | +What it does | +
|---|---|
rgit watch |
+ free, deterministic background capture that stages raw material as you edit, so fleeting in-between states aren't lost | +
rgit capture [REV | A..B] |
+ bare: auto-picks the working tree or, when clean, the last commit; pass a commit or an A..B range for precise control | +
rgit install-hooks |
+ opt-in: stage every commit's diff via a post-commit hook (not installed by rgit install; won't touch an existing hook). See install details above |
+
rgit run --from <capsule> -- <command> |
+ run and record an experiment for an implementation regenerated from a Capsule; after its Proposal is approved, the resulting Capsule is saved as a variant_of the source |
+
rgit compare <query> |
+ which variant won: ranked table, Δ vs baseline, ★ winner | +
rgit provenance <run_id> |
+ per-feature clean (capsule) vs agent-adapted (frozen) diff for a run | +
rgit mcp |
+ serve the graph read-only so a teammate's client can recall against it | +
rgit digest scan [A..B] |
+ cluster a mature repo's git history into a scored digestion plan (rgit init offers this interactively); rgit digest status shows progress, the rgit-digest skill drains the queue into origin=backfill capsules, and rgit digest clear removes them all if you change your mind |
+
- MIT © Stepzero Lab
-
- Core contributors: Yuxiang Lin · Fengrong Wan · Jiajun Sun
-