repolith 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +19 -1
  2. package/dist/cli.js +38644 -9099
  3. package/package.json +4 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Make a set of independent git repos feel like one monorepo — without touching git internals, GitHub, or CI.
4
4
 
5
- **Status: v0.1 — CLI complete.** All seven commands (`sync`, `status`, `grep`, `log`, `diff`, `exec`, `init`) are implemented and tested, and a VS Code extension is included. The MCP server and `checkout` (restore-from-lockfile) are next (v0.2). APIs may still change pre-1.0.
5
+ **Status: v0.3 — CLI + MCP server.** All CLI commands (`sync`, `checkout`, `status`, `grep`, `log`, `diff`, `exec`, `init`, `bisect`, `state`, `freeze`, `open`) are implemented and tested with `--json` on the read commands plus an **MCP server** (`repolith mcp`) so AI agents can query and restore workspace state, and a VS Code extension. APIs may still change pre-1.0.
6
6
 
7
7
  ## What it is
8
8
 
@@ -32,8 +32,26 @@ repolith sync # clone/checkout every repo, write the lockfile
32
32
  repolith status # branch + dirty/clean + ahead/behind, per repo
33
33
  repolith grep "TODO" # search across all repos at once
34
34
  repolith exec "npm test" # run a command in every repo
35
+ repolith checkout # restore every repo to the locked commit (deterministic)
36
+ repolith bisect --good good.lock.json --test "npm test" # find the repo+commit that broke the system
37
+ repolith state --json # print the atomic hash + per-repo commits (scriptable)
38
+ repolith freeze snap.json # write a shareable snapshot of the current state
39
+ repolith open snap.json # reconstruct the exact system from a shared snapshot
35
40
  ```
36
41
 
42
+ `status`, `grep`, `log`, `diff`, and `state` all accept `--json` for scripting and agent/CI use.
43
+
44
+ ## For AI agents (MCP)
45
+
46
+ `repolith` ships an [MCP](https://modelcontextprotocol.io) server so coding agents can query and reconstruct multi-repo state deterministically — *git pins a repo; repolith pins a system.*
47
+
48
+ ```bash
49
+ # register with Claude Code (read-only by default)
50
+ claude mcp add repolith -- repolith mcp --manifest /path/to/repolith.toml
51
+ ```
52
+
53
+ Tools exposed: `repolith_state` (atomic hash + per-repo commits), `repolith_status`, `repolith_grep`, `repolith_diff`. The mutating `repolith_checkout` is only exposed with `--allow-write`; `exec` is never exposed.
54
+
37
55
  ### Example `repolith.toml`
38
56
 
39
57
  ```toml