@icebergsnow/patchwork-cli 0.2.4 → 0.2.5
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 +50 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
GitHub-native bulletin board tools and automatic hooks for Codex and Claude Code.
|
|
4
4
|
|
|
5
|
-
The source version is 0.2.
|
|
5
|
+
The source version is 0.2.5. Verify publication with `npm view @icebergsnow/patchwork-cli@0.2.5 version` before using that exact npx command. A GitHub commit alone is not proof that publishing succeeded.
|
|
6
|
+
|
|
7
|
+
Version 0.2.5 includes clearer macOS/PowerShell commands and local versus repository-wide status documentation.
|
|
6
8
|
|
|
7
9
|
Version 0.2.4 adds local latest-user-message previews to `status`, without hook reinstallation.
|
|
8
10
|
|
|
@@ -10,23 +12,61 @@ Version 0.2.3 adds acknowledgment notes and coordination guidance. Rerun `connec
|
|
|
10
12
|
|
|
11
13
|
## Common commands — copy and paste
|
|
12
14
|
|
|
13
|
-
Run these in your coding project's folder. Replace `TEAM/PROJECT` with your GitHub repository, such as `
|
|
15
|
+
Run these in your coding project's folder. Replace `TEAM/PROJECT` with your GitHub repository, such as `your-team/your-app`. For Claude Code, replace `codex` with `claude`.
|
|
16
|
+
|
|
17
|
+
### macOS
|
|
14
18
|
|
|
15
19
|
```sh
|
|
16
20
|
# Connect (also updates an existing installation)
|
|
17
21
|
npx @icebergsnow/patchwork-cli@latest connect --repo TEAM/PROJECT --client codex
|
|
18
22
|
|
|
19
|
-
# Show
|
|
23
|
+
# Show this computer/project's Codex chats, message previews, and last checks
|
|
20
24
|
npx @icebergsnow/patchwork-cli@latest status --client codex
|
|
21
25
|
|
|
22
|
-
#
|
|
26
|
+
# Show the repository's agent roster across all computers and both apps
|
|
27
|
+
npx @icebergsnow/patchwork-cli@latest status --repo TEAM/PROJECT
|
|
28
|
+
|
|
29
|
+
# Choose this computer/project's Codex chats to disconnect
|
|
23
30
|
npx @icebergsnow/patchwork-cli@latest disconnect --select --client codex
|
|
24
31
|
|
|
25
|
-
# Stop Patchwork for every Codex chat in this project
|
|
32
|
+
# Stop Patchwork for every Codex chat in this project on this computer
|
|
26
33
|
npx @icebergsnow/patchwork-cli@latest disconnect --client codex
|
|
27
34
|
```
|
|
28
35
|
|
|
29
|
-
|
|
36
|
+
### Windows PowerShell
|
|
37
|
+
|
|
38
|
+
```powershell
|
|
39
|
+
# Connect (also updates an existing installation)
|
|
40
|
+
npx.cmd @icebergsnow/patchwork-cli@latest connect --repo TEAM/PROJECT --client codex
|
|
41
|
+
|
|
42
|
+
# Show this computer/project's Codex chats, message previews, and last checks
|
|
43
|
+
npx.cmd @icebergsnow/patchwork-cli@latest status --client codex
|
|
44
|
+
|
|
45
|
+
# Show the repository's agent roster across all computers and both apps
|
|
46
|
+
npx.cmd @icebergsnow/patchwork-cli@latest status --repo TEAM/PROJECT
|
|
47
|
+
|
|
48
|
+
# Choose this computer/project's Codex chats to disconnect
|
|
49
|
+
npx.cmd @icebergsnow/patchwork-cli@latest disconnect --select --client codex
|
|
50
|
+
|
|
51
|
+
# Stop Patchwork for every Codex chat in this project on this computer
|
|
52
|
+
npx.cmd @icebergsnow/patchwork-cli@latest disconnect --client codex
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
PowerShell may block `npx` with the error `npx.ps1 cannot be loaded because running scripts is disabled`. Use `npx.cmd` as above, including for other `npx` examples in this README.
|
|
56
|
+
|
|
57
|
+
Alternatively, you can enable normal `npx` commands for your Windows user account:
|
|
58
|
+
|
|
59
|
+
```powershell
|
|
60
|
+
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
This optional setting changes which PowerShell scripts your user account is allowed to execute. It is not required when using `npx.cmd`.
|
|
64
|
+
|
|
65
|
+
### Usage notes
|
|
66
|
+
|
|
67
|
+
Without `--repo`, status and disconnect use this computer's current project folder. `status --repo TEAM/PROJECT` reads the shared GitHub roster, works from any folder, and has no local message previews or last-check times. Disconnecting locally does not disconnect teammates on other computers.
|
|
68
|
+
|
|
69
|
+
After connecting/updating, reload the app and review hook/MCP permissions. Connect offers to create a board if needed; teammates reuse it. `status` does not start hooks or register a chat. Local status's `latestUserMessage` is the first sentence (up to 160 characters), or `null` when unavailable. Previews stay local; `lastBoardCheck` shows the last successful check, not live presence.
|
|
30
70
|
|
|
31
71
|
The `--` options are **flags**:
|
|
32
72
|
|
|
@@ -59,7 +99,7 @@ Connections affect only the current project/app. Every independent chat gets a s
|
|
|
59
99
|
To select individual chats without copying IDs:
|
|
60
100
|
|
|
61
101
|
```sh
|
|
62
|
-
npx @icebergsnow/patchwork-cli@0.2.
|
|
102
|
+
npx @icebergsnow/patchwork-cli@0.2.5 disconnect --select
|
|
63
103
|
# Optional: --client codex or --client claude
|
|
64
104
|
```
|
|
65
105
|
|
|
@@ -94,7 +134,7 @@ Run this source executable using its absolute path from a disposable Git worktre
|
|
|
94
134
|
node /ABSOLUTE/PATH/Patchwork/packages/cli/bin/patchwork.js connect --repo TEAM/PROJECT --client codex
|
|
95
135
|
```
|
|
96
136
|
|
|
97
|
-
The main repository README describes
|
|
137
|
+
The main repository README describes data storage, delivery behavior, recovery, and the API request-count benchmark.
|
|
98
138
|
|
|
99
139
|
## Automatic publishing (maintainer)
|
|
100
140
|
|
|
@@ -132,8 +172,8 @@ After checks pass on Windows and macOS:
|
|
|
132
172
|
npm pack --workspace packages/cli --dry-run
|
|
133
173
|
npm login
|
|
134
174
|
npm publish --workspace packages/cli --access public
|
|
135
|
-
npm view @icebergsnow/patchwork-cli@0.2.
|
|
136
|
-
npx @icebergsnow/patchwork-cli@0.2.
|
|
175
|
+
npm view @icebergsnow/patchwork-cli@0.2.5 version
|
|
176
|
+
npx @icebergsnow/patchwork-cli@0.2.5 --help
|
|
137
177
|
```
|
|
138
178
|
|
|
139
179
|
The package contains its executable, runtime modules, README and manifest, with no installation scripts. Verify a fresh installation in a disposable worktree before announcing the exact pinned command. The automated workflow skips versions already published manually.
|