@wrktr/cli 0.3.0 → 0.4.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 +80 -10
- package/package.json +8 -8
package/README.md
CHANGED
|
@@ -53,6 +53,7 @@ wrktr daemon install # keep worktrees committed, pushed and up to dat
|
|
|
53
53
|
wrktr branch new fix-login # a branch in its own worktree, under .wrktr/worktrees/fix-login
|
|
54
54
|
cd .wrktr/worktrees/fix-login # ...and just edit: the daemon commits and pushes after a quiet moment
|
|
55
55
|
wrktr status # checks, the review, open threads, conflicts
|
|
56
|
+
wrktr ci show --wait # wait for the checks; exits 1 unless they passed
|
|
56
57
|
wrktr feedback show # what the review asked for
|
|
57
58
|
wrktr feedback reply <id> "Fixed: the token now refreshes before it expires."
|
|
58
59
|
wrktr land --when-ready # lands by itself once checks, the review and threads allow it
|
|
@@ -62,15 +63,15 @@ wrktr land --when-ready # lands by itself once checks, the review and th
|
|
|
62
63
|
|
|
63
64
|
Every command takes these, before or after the subcommand.
|
|
64
65
|
|
|
65
|
-
| Flag |
|
|
66
|
-
| ------------------------ |
|
|
67
|
-
| `--project <org>/<name>` | Act on that project on wrktr instead of the clone you're in. No clone is needed, so name the branch too (`--branch`, or the command's branch argument). Commands that act on this machine or your account (`login`, `whoami`, `token`, `init`, `clone`, `branch new`, `branch
|
|
68
|
-
| `--json` | Print the result as JSON on stdout, and a failure as JSON on stderr. See [JSON output](#json-output-and-exit-codes).
|
|
69
|
-
| `--help`, `-h` | Help for any command.
|
|
70
|
-
| `--version`, `-v` | The CLI's version and build.
|
|
71
|
-
| `--log-level <level>` | `all`, `trace`, `debug`, `info`, `warn`, `error`, `fatal` or `none`.
|
|
72
|
-
| `--completions <shell>` | Print a completion script for `bash`, `zsh`, `fish` or `sh`.
|
|
73
|
-
| `--wizard` | Build a command interactively.
|
|
66
|
+
| Flag | |
|
|
67
|
+
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
68
|
+
| `--project <org>/<name>` | Act on that project on wrktr instead of the clone you're in. No clone is needed, so name the branch too (`--branch`, or the command's branch argument). Commands that act on this machine or your account (`login`, `whoami`, `token`, `init`, `clone`, `branch new`, `branch rm`, `branch ls` without `--all`, `skill`, `daemon`) refuse it. |
|
|
69
|
+
| `--json` | Print the result as JSON on stdout, and a failure as JSON on stderr. See [JSON output](#json-output-and-exit-codes). |
|
|
70
|
+
| `--help`, `-h` | Help for any command. |
|
|
71
|
+
| `--version`, `-v` | The CLI's version and build. |
|
|
72
|
+
| `--log-level <level>` | `all`, `trace`, `debug`, `info`, `warn`, `error`, `fatal` or `none`. |
|
|
73
|
+
| `--completions <shell>` | Print a completion script for `bash`, `zsh`, `fish` or `sh`. |
|
|
74
|
+
| `--wizard` | Build a command interactively. |
|
|
74
75
|
|
|
75
76
|
## Commands
|
|
76
77
|
|
|
@@ -138,7 +139,20 @@ reused only if that branch is fully merged.
|
|
|
138
139
|
|
|
139
140
|
#### `wrktr branch ls`
|
|
140
141
|
|
|
141
|
-
The branches that have a worktree on this machine.
|
|
142
|
+
The branches that have a worktree on this machine. With `--all`, every branch in progress on wrktr instead (its
|
|
143
|
+
head, state and when it last moved, newest first), from anywhere: it takes `--project`.
|
|
144
|
+
|
|
145
|
+
| Flag | |
|
|
146
|
+
| ---------- | --------------------------------------------------- |
|
|
147
|
+
| `--all` | List the branches on wrktr, not the worktrees here. |
|
|
148
|
+
| `--landed` | With `--all`, include branches that landed. |
|
|
149
|
+
| `--closed` | With `--all`, include branches that were closed. |
|
|
150
|
+
|
|
151
|
+
#### `wrktr branch show [<name>]`
|
|
152
|
+
|
|
153
|
+
What a branch does: the review agent's description of it (a title, a summary, the changes by area, risks and how
|
|
154
|
+
to check it), its head and its state. The description follows the branch as it moves; it says so when it was
|
|
155
|
+
written for an older head.
|
|
142
156
|
|
|
143
157
|
#### `wrktr branch rm <name>`
|
|
144
158
|
|
|
@@ -162,6 +176,26 @@ reviews stay.
|
|
|
162
176
|
|
|
163
177
|
Reopen a closed branch.
|
|
164
178
|
|
|
179
|
+
### Code
|
|
180
|
+
|
|
181
|
+
Read a project's history and changes from wrktr, no clone needed.
|
|
182
|
+
|
|
183
|
+
#### `wrktr log [<ref>]`
|
|
184
|
+
|
|
185
|
+
Commits, newest first: short sha, date, author and subject. `<ref>` is a branch or a commit; it defaults to the
|
|
186
|
+
worktree's branch, or the default branch outside a clone. `--limit <n>` for how many (default 20).
|
|
187
|
+
|
|
188
|
+
#### `wrktr diff [<branch>]`
|
|
189
|
+
|
|
190
|
+
What a branch changes against its base: by default a stat, one line per file (`A`dded, `M`odified, `D`eleted,
|
|
191
|
+
`+added -deleted` lines), then the totals.
|
|
192
|
+
|
|
193
|
+
| Flag | |
|
|
194
|
+
| ----------------- | ---------------------------------------------------------- |
|
|
195
|
+
| `--patch`, `-p` | Every file's changes as a unified diff, like `git diff`. |
|
|
196
|
+
| `--file <path>` | Only this file's changes, as a unified diff. |
|
|
197
|
+
| `--base <branch>` | Compare against this branch (default: the default branch). |
|
|
198
|
+
|
|
165
199
|
### Where a branch stands
|
|
166
200
|
|
|
167
201
|
#### `wrktr status`
|
|
@@ -209,6 +243,42 @@ to the branch's head.
|
|
|
209
243
|
|
|
210
244
|
Set a review aside so it no longer counts. `<id>` can be the start of an id from `review ls`.
|
|
211
245
|
|
|
246
|
+
#### `wrktr review request [<branch>]`
|
|
247
|
+
|
|
248
|
+
Ask the review agent to review the branch's head now, replacing a review of it. It reviews by itself after each
|
|
249
|
+
push once checks pass; this is for a review that failed, or a fresh look at the same head.
|
|
250
|
+
|
|
251
|
+
### CI
|
|
252
|
+
|
|
253
|
+
Each push runs the checks in `wrktr.json` `ci`. The review agent reads their results, and `land` waits for the
|
|
254
|
+
required ones to pass.
|
|
255
|
+
|
|
256
|
+
#### `wrktr ci show [<run>]`
|
|
257
|
+
|
|
258
|
+
A CI run: each check's state, time and notes (optional, cached, exit code, a retry), and the last lines of the
|
|
259
|
+
ones that failed. Without `<run>`, the branch head's run. `<run>` can be the start of an id from `ci runs`.
|
|
260
|
+
|
|
261
|
+
| Flag | |
|
|
262
|
+
| --------------------- | -------------------------------------------------------------------------------------------------------- |
|
|
263
|
+
| `--branch <name>` | The branch. |
|
|
264
|
+
| `--wait` | Wait until the head's run is over, then exit `1` unless it passed: `wrktr ci show --wait && wrktr land`. |
|
|
265
|
+
| `--timeout <seconds>` | With `--wait`, give up after this long (default 1800), exiting `1`. |
|
|
266
|
+
|
|
267
|
+
#### `wrktr ci runs`
|
|
268
|
+
|
|
269
|
+
The project's CI runs, newest first: status, branch, commit, how long each took. `--branch <name>` for one
|
|
270
|
+
branch's; `--limit <n>` for how many (default 10).
|
|
271
|
+
|
|
272
|
+
#### `wrktr ci log <check>`
|
|
273
|
+
|
|
274
|
+
A check's full log, as stored when it finished (`ci show` prints only the last lines of a failed one). Defaults
|
|
275
|
+
to the branch head's run: `--run <id>` for another, `--branch <name>` for another branch's head.
|
|
276
|
+
|
|
277
|
+
#### `wrktr ci rerun`
|
|
278
|
+
|
|
279
|
+
Run the branch head's checks again, ignoring results reused from an identical tree (for a flaky check, or one
|
|
280
|
+
that depends on something outside the repo). `--branch <name>` for another branch.
|
|
281
|
+
|
|
212
282
|
### Landing
|
|
213
283
|
|
|
214
284
|
#### `wrktr land [<branch>]`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wrktr/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Agent-first git on Cloudflare: a branch and a worktree per agent, live review, CI and landing.",
|
|
5
5
|
"homepage": "https://wrktr.com",
|
|
6
6
|
"bin": {
|
|
@@ -10,12 +10,12 @@
|
|
|
10
10
|
"bin"
|
|
11
11
|
],
|
|
12
12
|
"optionalDependencies": {
|
|
13
|
-
"@wrktr/cli-darwin-arm64": "0.
|
|
14
|
-
"@wrktr/cli-darwin-x64": "0.
|
|
15
|
-
"@wrktr/cli-linux-x64": "0.
|
|
16
|
-
"@wrktr/cli-linux-arm64": "0.
|
|
17
|
-
"@wrktr/cli-linux-x64-musl": "0.
|
|
18
|
-
"@wrktr/cli-linux-arm64-musl": "0.
|
|
19
|
-
"@wrktr/cli-windows-x64": "0.
|
|
13
|
+
"@wrktr/cli-darwin-arm64": "0.4.0",
|
|
14
|
+
"@wrktr/cli-darwin-x64": "0.4.0",
|
|
15
|
+
"@wrktr/cli-linux-x64": "0.4.0",
|
|
16
|
+
"@wrktr/cli-linux-arm64": "0.4.0",
|
|
17
|
+
"@wrktr/cli-linux-x64-musl": "0.4.0",
|
|
18
|
+
"@wrktr/cli-linux-arm64-musl": "0.4.0",
|
|
19
|
+
"@wrktr/cli-windows-x64": "0.4.0"
|
|
20
20
|
}
|
|
21
21
|
}
|