@rness/cli 0.10.0 → 0.11.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.
- package/README.md +42 -1
- package/dist/bin/rness.js +1 -1
- package/dist/{chunk-R4BRAAC2.js → chunk-LW4S5OLI.js} +478 -65
- package/dist/chunk-LW4S5OLI.js.map +1 -0
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-R4BRAAC2.js.map +0 -1
package/README.md
CHANGED
|
@@ -28,6 +28,7 @@ Inside a workspace, every `rness` delegates to the copy pinned in
|
|
|
28
28
|
rness login [--setup-git|--no-setup-git]
|
|
29
29
|
rness logout
|
|
30
30
|
rness context [--scope <name>] [--json]
|
|
31
|
+
rness status [<tab>]
|
|
31
32
|
rness validate
|
|
32
33
|
rness mcp
|
|
33
34
|
|
|
@@ -41,6 +42,28 @@ writes nothing and exits 1 when a block is out of date — use it in CI.
|
|
|
41
42
|
`.rness/` goes to the network. Bring repositories in with
|
|
42
43
|
`rness add <owner>/<repo>` or a git URL — a bare name needs an `"org"`.
|
|
43
44
|
|
|
45
|
+
### Status
|
|
46
|
+
|
|
47
|
+
rness status # every decision, specification and plan, a tab per directory
|
|
48
|
+
rness status specs # open on one tab (off a terminal: print only that one)
|
|
49
|
+
|
|
50
|
+
A tab for `ADR`, `Specs` and `Plans`, always, then one for each other
|
|
51
|
+
directory of `.rness/` whose Markdown files carry a `status` in their front
|
|
52
|
+
matter (a `marketing/` of dated posts, say). A line per document, newest
|
|
53
|
+
first: its number (or date), its title, its status — green when done, grey
|
|
54
|
+
when dropped, red `?` when missing.
|
|
55
|
+
|
|
56
|
+
- In a terminal, a full-screen view: `←`/`→` or `Tab` change tab, `↑`/`↓`,
|
|
57
|
+
`PgUp`/`PgDn`, `Home`/`End` scroll, `q` or `Esc` closes and gives the
|
|
58
|
+
screen back. Read-only.
|
|
59
|
+
- Off a terminal — a pipe, CI, an agent's tool — Markdown: a table per tab.
|
|
60
|
+
- From Claude Code, `/rness:status [tab]` shows those tables (see "Agent
|
|
61
|
+
targets"). For the view itself: `Ctrl+Z` suspends Claude Code, run
|
|
62
|
+
`npx @rness/cli status` (or `rness status` with a global install), `q`,
|
|
63
|
+
then `fg` resumes it — the skill ends with that line. Nothing started from inside
|
|
64
|
+
Claude Code gets the terminal, so the view cannot open from there
|
|
65
|
+
(verified with Claude Code 2.1.284 on 2026-09-29).
|
|
66
|
+
|
|
44
67
|
### Agent targets
|
|
45
68
|
|
|
46
69
|
The `AGENTS.md` block is what every agent reads. On top of it, rness writes
|
|
@@ -65,7 +88,12 @@ the files a given agent needs, for the agents the team declares in
|
|
|
65
88
|
with Claude Code 2.1.284 on 2026-09-29. Each clone also gets `.mcp.json`,
|
|
66
89
|
which registers the MCP server; see "MCP server". The same settings file
|
|
67
90
|
carries two hooks, and so does `.claude/settings.json` at the workspace
|
|
68
|
-
root, which `sync` writes on every machine; see "Hooks".
|
|
91
|
+
root, which `sync` writes on every machine; see "Hooks". Both places also
|
|
92
|
+
get a Claude Code plugin, `.claude/skills/rness/`, with one command:
|
|
93
|
+
`/rness:status [tab]`, the tables of `rness status`. rness owns those
|
|
94
|
+
files whole — an edit by hand is reported by `sync --check` and written
|
|
95
|
+
back by `sync` — and nothing in them depends on the version. Claude Code
|
|
96
|
+
loads the plugin once the folder is trusted, in a session started there.
|
|
69
97
|
- rness owns values, not files: what is missing is added, nothing else is
|
|
70
98
|
touched, and a file it cannot parse is reported, never rewritten.
|
|
71
99
|
`sync --check` and `validate` report a missing value. Removing an agent
|
|
@@ -278,6 +306,19 @@ per repository, the files to commit there.
|
|
|
278
306
|
Exit codes: 0 success, 1 failure, 2 usage — or a refusal without a TTY.
|
|
279
307
|
`RNESS_DEBUG=1` adds stack traces; `RNESS_NO_DELEGATE=1` skips the delegation.
|
|
280
308
|
|
|
309
|
+
## 0.11.0 — `rness status`; `/rness:status` in Claude Code
|
|
310
|
+
|
|
311
|
+
- `rness status [tab]`: every decision, specification and plan — and any
|
|
312
|
+
other directory of `.rness/` whose documents carry a status — a tab per
|
|
313
|
+
directory, a line per document. A full-screen view in a terminal,
|
|
314
|
+
Markdown off one. See "Status".
|
|
315
|
+
- With `claude` in `agents`, `sync` writes the `rness` plugin
|
|
316
|
+
(`.claude/skills/rness/`) in each clone and at the workspace root:
|
|
317
|
+
`/rness:status` in Claude Code. `rness upgrade` syncs, so it adds them;
|
|
318
|
+
then commit `.claude/skills/rness/` in each repository, as its next steps
|
|
319
|
+
list. Until then `sync --check` and `validate` report the files missing.
|
|
320
|
+
- Blocks are unchanged.
|
|
321
|
+
|
|
281
322
|
## 0.10.0 — hooks: the context at session start, validation after an edit
|
|
282
323
|
|
|
283
324
|
- With `claude` in `agents`, `sync` adds two hooks to each clone's
|