@rness/cli 0.5.3 → 0.6.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.
- package/README.md +51 -5
- package/dist/bin/rness.js +1 -1
- package/dist/{chunk-CQ6YD63L.js → chunk-YAIZOFYV.js} +434 -222
- package/dist/chunk-YAIZOFYV.js.map +1 -0
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-CQ6YD63L.js.map +0 -1
package/README.md
CHANGED
|
@@ -6,8 +6,12 @@ Not an agent — no LLM loop.
|
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
9
|
-
npm create rness #
|
|
9
|
+
npm create rness # asks how to start: a GitHub organization, or a blank workspace
|
|
10
10
|
npm create rness acme # the organization github.com/acme, no first prompt
|
|
11
|
+
pnpm create rness demo --blank # ./demo with no GitHub step; npm: npm create rness demo -- --blank
|
|
12
|
+
pnpm create rness # the same with pnpm, yarn or bun: `.rness/` is
|
|
13
|
+
yarn create rness # installed with the manager that ran the command
|
|
14
|
+
bun create rness
|
|
11
15
|
npm i -g @rness/cli # the command is `rness`
|
|
12
16
|
npx @rness/cli --help
|
|
13
17
|
|
|
@@ -17,6 +21,7 @@ Inside a workspace, every `rness` delegates to the copy pinned in
|
|
|
17
21
|
## Commands
|
|
18
22
|
|
|
19
23
|
rness create [<org>] [--repos a,b] [--pm npm|pnpm|yarn|bun] [--ssh|--https] [--skip-install] -y
|
|
24
|
+
rness create <name> --blank [--pm npm|pnpm|yarn|bun] [--skip-install] -y
|
|
20
25
|
rness add <repo> [--scopes apps/web,packages/ui] [--ssh|--https] -y
|
|
21
26
|
rness sync [--all] [--scope <name>] [--check] [--pull] -y
|
|
22
27
|
rness upgrade [<version>] -y
|
|
@@ -29,6 +34,12 @@ Inside a workspace, every `rness` delegates to the copy pinned in
|
|
|
29
34
|
confirmation in a terminal; pass `-y`/`--yes` in scripts. `sync --check`
|
|
30
35
|
writes nothing and exits 1 when a block is out of date — use it in CI.
|
|
31
36
|
|
|
37
|
+
`create --blank` needs no GitHub organization, account or login: it writes
|
|
38
|
+
`<name>/.rness/` (a `rness.json` without `"org"`, committed), an empty
|
|
39
|
+
`<name>/org/` and the root `AGENTS.md` and `CLAUDE.md`. Only the install of
|
|
40
|
+
`.rness/` goes to the network. Bring repositories in with
|
|
41
|
+
`rness add <owner>/<repo>` or a git URL — a bare name needs an `"org"`.
|
|
42
|
+
|
|
32
43
|
### Log in
|
|
33
44
|
|
|
34
45
|
rness login # shows a code and https://github.com/login/device
|
|
@@ -136,6 +147,37 @@ its content does.
|
|
|
136
147
|
Exit codes: 0 success, 1 failure, 2 usage — or a refusal without a TTY.
|
|
137
148
|
`RNESS_DEBUG=1` adds stack traces; `RNESS_NO_DELEGATE=1` skips the delegation.
|
|
138
149
|
|
|
150
|
+
## 0.6.1 — hints you can type
|
|
151
|
+
|
|
152
|
+
- Every hint that names a command to run (`not cloned: …`, `run … sync`,
|
|
153
|
+
`run … login`, `… upgrade <version>`) spells rness the way it was
|
|
154
|
+
launched: `npx @rness/cli`, `pnpm dlx @rness/cli`, `yarn dlx @rness/cli`
|
|
155
|
+
(npx on Yarn 1), `bunx @rness/cli`, or `rness` when it was typed directly.
|
|
156
|
+
The next steps of `create` follow the same rule; `--pm`, which chooses what
|
|
157
|
+
`.rness/` installs with, no longer decides them.
|
|
158
|
+
- Under `rness-dev` (`RNESS_NO_DELEGATE=1`), `create` writes its first blocks
|
|
159
|
+
from the sources rather than through the copy it just installed.
|
|
160
|
+
- Blocks are unchanged: no `rness sync` is needed after upgrading.
|
|
161
|
+
|
|
162
|
+
## 0.6.0 — a workspace without GitHub
|
|
163
|
+
|
|
164
|
+
- `rness create <name> --blank` writes `<name>/.rness/` (a `rness.json`
|
|
165
|
+
without `"org"`, committed), an empty `<name>/org/` and the root
|
|
166
|
+
`AGENTS.md` and `CLAUDE.md`, with no login, SSH test or GitHub request.
|
|
167
|
+
With `npm create`, flags go after `--`: `npm create rness demo -- --blank`.
|
|
168
|
+
- In a terminal, `create` with no organization and no `--repos` first asks
|
|
169
|
+
how to start: from a GitHub organization, as before, or a blank local
|
|
170
|
+
workspace.
|
|
171
|
+
- A `rness.json` without `"org"` is no longer a warning in `sync`, `add` and
|
|
172
|
+
`validate`. In such a workspace `rness add <repo>` exits 2 and asks for
|
|
173
|
+
`<owner>/<repo>` or a git URL: it used to take the directory name as the
|
|
174
|
+
owner, a repository that almost never exists.
|
|
175
|
+
- The next steps `create` prints are written with the package manager that
|
|
176
|
+
ran it: `npx @rness/cli`, `pnpm dlx @rness/cli`, `yarn dlx @rness/cli`
|
|
177
|
+
(npx on Yarn 1), `bunx @rness/cli`, and `<pm> create rness <org>` for
|
|
178
|
+
teammates. They said `rness …`, a command `npm create` never installs.
|
|
179
|
+
- Blocks are unchanged: no `rness sync` is needed after upgrading.
|
|
180
|
+
|
|
139
181
|
## 0.5.3 — catching up no longer depends on the global install
|
|
140
182
|
|
|
141
183
|
- After a pull that moved the pin, the next `rness` command installs it. That
|
|
@@ -287,12 +329,16 @@ To reach it from a workspace elsewhere on the machine, link it once:
|
|
|
287
329
|
ln -s "$PWD/scripts/dev.mjs" ~/.local/bin/rness-dev # from the repository root
|
|
288
330
|
cd ~/somewhere/acme && rness-dev validate
|
|
289
331
|
|
|
290
|
-
`create` is never delegated, so it always runs these sources —
|
|
291
|
-
|
|
332
|
+
`create` is never delegated, so it always runs these sources — the blocks it
|
|
333
|
+
writes at the end included, even once it has installed the pinned copy — and
|
|
334
|
+
it refuses to run inside a workspace, so call it from an empty directory.
|
|
292
335
|
|
|
293
336
|
`pnpm verdaccio` is the other loop: a local registry that serves this build as
|
|
294
337
|
a real package, for what only shows up through an install (`npm create rness`,
|
|
295
|
-
the pinned copy, a version bump).
|
|
296
|
-
|
|
338
|
+
the pinned copy, a version bump). Each `pnpm verdaccio deploy` publishes a
|
|
339
|
+
version of its own — `0.6.1-dev.<time>` for sources at 0.6.0 — so a new
|
|
340
|
+
workspace pins exactly that build and no cache serves an older one under its
|
|
341
|
+
number. To try it in a workspace that exists, run `rness upgrade <version>`
|
|
342
|
+
inside it; the deploy prints the line.
|
|
297
343
|
|
|
298
344
|
Node ≥ 24. MIT.
|