@wrktr/cli 0.5.0 → 0.5.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 +68 -42
- package/package.json +8 -8
package/README.md
CHANGED
|
@@ -125,45 +125,46 @@ wrktr status --project nope/nope --branch x --json # exit 1
|
|
|
125
125
|
|
|
126
126
|
Every command at a glance. Each area links to its part of the full [reference](#commands).
|
|
127
127
|
|
|
128
|
-
| Command
|
|
129
|
-
|
|
|
130
|
-
| **[Account](#account)**
|
|
131
|
-
| `wrktr login`
|
|
132
|
-
| `wrktr whoami`
|
|
133
|
-
| `wrktr token ls` / `create` / `revoke`
|
|
134
|
-
| **[Projects](#projects)**
|
|
135
|
-
| `wrktr init`
|
|
136
|
-
| `wrktr clone <org>/<project>`
|
|
137
|
-
| `wrktr project
|
|
138
|
-
|
|
|
139
|
-
|
|
|
140
|
-
| `wrktr org
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
| `wrktr branch
|
|
144
|
-
| `wrktr branch
|
|
145
|
-
|
|
|
146
|
-
|
|
|
147
|
-
| `wrktr
|
|
148
|
-
|
|
|
149
|
-
|
|
|
150
|
-
| `wrktr
|
|
151
|
-
|
|
|
152
|
-
|
|
|
153
|
-
| `wrktr review
|
|
154
|
-
|
|
|
155
|
-
|
|
|
156
|
-
|
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
|
|
|
160
|
-
| `wrktr env
|
|
161
|
-
|
|
|
162
|
-
|
|
|
163
|
-
|
|
|
164
|
-
|
|
|
165
|
-
|
|
|
166
|
-
|
|
|
128
|
+
| Command | What it does |
|
|
129
|
+
| ----------------------------------------------------- | ----------------------------------------------------- |
|
|
130
|
+
| **[Account](#account)** | |
|
|
131
|
+
| `wrktr login` | Sign this machine in through the browser |
|
|
132
|
+
| `wrktr whoami` | Who the CLI acts as, and their organizations |
|
|
133
|
+
| `wrktr token ls` / `create` / `revoke` | Access tokens for CI and other agents |
|
|
134
|
+
| **[Projects](#projects)** | |
|
|
135
|
+
| `wrktr init` | Put the repo you're in on wrktr |
|
|
136
|
+
| `wrktr clone <org>/<project>` | Clone a project and register it with the daemon |
|
|
137
|
+
| `wrktr credential <org>/<project> get` | git's credential helper, so plain `git pull` works |
|
|
138
|
+
| `wrktr project ls` / `show` / `create` / `visibility` | List, inspect and create projects; make one public |
|
|
139
|
+
| **[Organizations](#organizations)** | |
|
|
140
|
+
| `wrktr org ls` / `show` / `create` / `rename` | Your organizations |
|
|
141
|
+
| `wrktr org members` / `add` / `role` / `remove` | The people in one, and their roles |
|
|
142
|
+
| **[Branches](#branches)** | |
|
|
143
|
+
| `wrktr branch new <name>` | A branch in its own worktree |
|
|
144
|
+
| `wrktr branch ls` / `show` / `rm` | List, describe and remove branches |
|
|
145
|
+
| `wrktr branch experiment` / `close` / `reopen` | Keep a branch from landing, or close it |
|
|
146
|
+
| **[Code](#code)** | |
|
|
147
|
+
| `wrktr log [<ref>]` | Commits, newest first |
|
|
148
|
+
| `wrktr diff [<branch>]` | What a branch changes against its base |
|
|
149
|
+
| **[Where a branch stands](#where-a-branch-stands)** | |
|
|
150
|
+
| `wrktr status` | Head, state, checks, review, threads, conflicts |
|
|
151
|
+
| `wrktr feedback show` / `reply` / `resolve` | Work through review threads |
|
|
152
|
+
| **[Reviews](#reviews)** | |
|
|
153
|
+
| `wrktr review ls` / `submit` / `dismiss` | Read, write and set aside reviews |
|
|
154
|
+
| `wrktr review request` | Ask the review agent to review the head now |
|
|
155
|
+
| **[CI](#ci)** | |
|
|
156
|
+
| `wrktr ci show` / `runs` / `log` / `rerun` | Runs, checks, logs, and running them again |
|
|
157
|
+
| **[Landing](#landing)** | |
|
|
158
|
+
| `wrktr land [<branch>]` | Land a branch now, or `--when-ready` |
|
|
159
|
+
| **[Deploys](#deploys)** | |
|
|
160
|
+
| `wrktr env ls` / `runs` / `show` / `logs` | Environments, their runs and step logs |
|
|
161
|
+
| `wrktr env promote` / `rerun` / `cancel` | Ship, retry or stop a deploy |
|
|
162
|
+
| **[Secrets](#secrets)** | |
|
|
163
|
+
| `wrktr secret set` / `ls` / `rm` | The project's deploy secrets (set from stdin) |
|
|
164
|
+
| **[The daemon](#the-daemon)** | |
|
|
165
|
+
| `wrktr daemon install` / `status` / `logs` / ... | The background service that commits, pushes and syncs |
|
|
166
|
+
| **[Agent skill](#agent-skill)** | |
|
|
167
|
+
| `wrktr skill install` / `show` | The skill that teaches agents the wrktr way |
|
|
167
168
|
|
|
168
169
|
## Global flags
|
|
169
170
|
|
|
@@ -219,7 +220,8 @@ Revoke a token. Whatever uses it stops working at once. `<id>` can be the start
|
|
|
219
220
|
#### `wrktr init`
|
|
220
221
|
|
|
221
222
|
Create a wrktr project for the repo you're in and push it, or link the repo to an existing one. It registers the
|
|
222
|
-
repo with the daemon
|
|
223
|
+
repo with the daemon and sets up [`wrktr credential`](#wrktr-credential-orgproject-get) so plain git works with
|
|
224
|
+
the remote.
|
|
223
225
|
|
|
224
226
|
| Flag | |
|
|
225
227
|
| --------------- | -------------------------------------------------------------------------------- |
|
|
@@ -228,7 +230,25 @@ repo with the daemon.
|
|
|
228
230
|
|
|
229
231
|
#### `wrktr clone <org>/<project> [<directory>]`
|
|
230
232
|
|
|
231
|
-
Clone a project (into `<directory>`, by default the project's name) and register it with the daemon.
|
|
233
|
+
Clone a project (into `<directory>`, by default the project's name) and register it with the daemon. Plain git
|
|
234
|
+
works in it from then on (see `wrktr credential`).
|
|
235
|
+
|
|
236
|
+
#### `wrktr credential <org>/<project> get`
|
|
237
|
+
|
|
238
|
+
git's credential helper for a wrktr remote: you don't run it, git does. The remote only takes short-lived tokens,
|
|
239
|
+
so instead of a saved password, `init` and `clone` set this in the repo's `.git/config`, for the remote's URL only:
|
|
240
|
+
|
|
241
|
+
```ini
|
|
242
|
+
[credential "https://…/git/<namespace>/<project>.git"]
|
|
243
|
+
helper =
|
|
244
|
+
helper = !wrktr credential <org>/<project>
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
Then `git pull`, `git fetch` and `git push` (and your editor's git) work as they do anywhere else: each time git
|
|
248
|
+
needs to authenticate, it gets a fresh token minted for you. The empty `helper =` keeps a global helper (such as
|
|
249
|
+
the macOS keychain) from storing a token that's about to expire. `store` and `erase` do nothing. Repos set up
|
|
250
|
+
before this get it the next time the daemon starts. When you're not signed in, git fails with the reason instead of
|
|
251
|
+
asking for a password.
|
|
232
252
|
|
|
233
253
|
#### `wrktr project ls [<org>]`
|
|
234
254
|
|
|
@@ -237,7 +257,7 @@ belong to.
|
|
|
237
257
|
|
|
238
258
|
#### `wrktr project show [<org>/<name>]`
|
|
239
259
|
|
|
240
|
-
A project: its default branch, last push, git remote and id. Defaults to the clone you're in, or `--project`.
|
|
260
|
+
A project: who can see it, its default branch, last push, git remote and id. Defaults to the clone you're in, or `--project`.
|
|
241
261
|
|
|
242
262
|
#### `wrktr project create <org>/<name>`
|
|
243
263
|
|
|
@@ -248,6 +268,12 @@ Create a project on wrktr without a local repo (for one you have locally, use `i
|
|
|
248
268
|
| `--import <url>` | Start it as a copy of an HTTPS git remote, such as a GitHub repo, instead of empty. |
|
|
249
269
|
| `--description <text>` | What the project is. |
|
|
250
270
|
|
|
271
|
+
#### `wrktr project visibility public|private`
|
|
272
|
+
|
|
273
|
+
Make the project public, so anyone can read its code, history, branches, reviews and CI, signed in or not, or private
|
|
274
|
+
again (its organization's members only). Owners only. Only members can ever change a project; someone outside it who
|
|
275
|
+
runs `wrktr clone` gets a read-only copy that `git pull` keeps current and the daemon leaves alone.
|
|
276
|
+
|
|
251
277
|
### Organizations
|
|
252
278
|
|
|
253
279
|
People are named by email. `<org>` defaults to the organization of the clone you're in, or of `--project`.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wrktr/cli",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.1",
|
|
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.5.
|
|
14
|
-
"@wrktr/cli-darwin-x64": "0.5.
|
|
15
|
-
"@wrktr/cli-linux-x64": "0.5.
|
|
16
|
-
"@wrktr/cli-linux-arm64": "0.5.
|
|
17
|
-
"@wrktr/cli-linux-x64-musl": "0.5.
|
|
18
|
-
"@wrktr/cli-linux-arm64-musl": "0.5.
|
|
19
|
-
"@wrktr/cli-windows-x64": "0.5.
|
|
13
|
+
"@wrktr/cli-darwin-arm64": "0.5.1",
|
|
14
|
+
"@wrktr/cli-darwin-x64": "0.5.1",
|
|
15
|
+
"@wrktr/cli-linux-x64": "0.5.1",
|
|
16
|
+
"@wrktr/cli-linux-arm64": "0.5.1",
|
|
17
|
+
"@wrktr/cli-linux-x64-musl": "0.5.1",
|
|
18
|
+
"@wrktr/cli-linux-arm64-musl": "0.5.1",
|
|
19
|
+
"@wrktr/cli-windows-x64": "0.5.1"
|
|
20
20
|
}
|
|
21
21
|
}
|