repolith 0.0.1 → 0.2.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 +15 -2
  2. package/dist/cli.js +39833 -1706
  3. package/package.json +12 -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: early / under active development (v0.0.x).** The name is reserved and the core is being built task-by-task. APIs and commands will change until v0.1.
5
+ **Status: v0.2 CLI + MCP server.** All CLI commands (`sync`, `checkout`, `status`, `grep`, `log`, `diff`, `exec`, `init`, `bisect`) are implemented and tested, 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
 
@@ -24,7 +24,7 @@ npm i -g repolith
24
24
  bun add -g repolith
25
25
  ```
26
26
 
27
- ## Quick start (target shape — not all commands shipped yet)
27
+ ## Quick start
28
28
 
29
29
  ```bash
30
30
  repolith init # interactively create repolith.toml
@@ -32,8 +32,21 @@ 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
35
37
  ```
36
38
 
39
+ ## For AI agents (MCP)
40
+
41
+ `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.*
42
+
43
+ ```bash
44
+ # register with Claude Code (read-only by default)
45
+ claude mcp add repolith -- repolith mcp --manifest /path/to/repolith.toml
46
+ ```
47
+
48
+ 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.
49
+
37
50
  ### Example `repolith.toml`
38
51
 
39
52
  ```toml