@divance/rrr 0.0.0-stage → 0.1.1

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 +21 -2
  2. package/dist/rrr.js +16696 -0
  3. package/package.json +32 -4
package/README.md CHANGED
@@ -1,3 +1,22 @@
1
- # Temporary Holding Version
1
+ # rrr
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Runs AI agents, records each run and its handoff on an rrrrr server, and fires pops (side effects) from the handoff.
4
+
5
+ ```bash
6
+ npm i -g @divance/rrr
7
+ rrr login # paste a runner token (minted with your pops' secrets); the hosted server is the default
8
+ rrr agent list --config <config repo>
9
+ rrr run <agent> --origin <ref> # or --chain <ch_id> to continue a chain
10
+ ```
11
+
12
+ `RRR_SERVER` / `--server` point at another server, `RRR_TOKEN` overrides the saved token, `RRR_CONFIG` sets the config repo.
13
+ In CI, pass the token only as `RRR_TOKEN` and don't `rrr login` (no credentials file). The agent runs in a temp
14
+ dir with an env allowlist. Read and sandboxed Bash are denied `~/.config/rrr`, rrr's cwd and your shell
15
+ startup files (`~/.bashrc`, `~/.bash_profile`, `~/.bash_login`, `~/.profile`, `~/.zshrc`, `~/.zshenv`, `~/.zprofile`,
16
+ `~/.zlogin`), and `RRR_TOKEN` is unset in Bash. Other variables your shell rc exports still reach Bash. MCP servers in
17
+ run.yaml run outside the sandbox with your file access (trusted config). Where Claude's sandbox can't start
18
+ (e.g. no bubblewrap), Bash is not sandboxed and only the Read rules hold. The real boundary is a container
19
+ ([design](https://github.com/divanc/rrrrr/blob/main/docs/design.md#harness)).
20
+ The CLI is one bundled file (`dist/rrr.js`); it needs Node 22+ and Claude Code on PATH.
21
+
22
+ Design: https://github.com/divanc/rrrrr/blob/main/docs/design.md