@filipc77/cowrite 0.4.24 → 0.4.26

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.
Files changed (2) hide show
  1. package/README.md +14 -16
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -38,10 +38,18 @@ A single Node.js process runs both the HTTP/WebSocket preview server and the MCP
38
38
  npm install -g @filipc77/cowrite
39
39
  ```
40
40
 
41
- This gives you the `cowrite` command globally.
41
+ This gives you the `cowrite` command globally (needed for `cowrite open`). Optional if you only use `npx`.
42
42
 
43
43
  ### 2. Add Cowrite as an MCP server in Claude Code
44
44
 
45
+ **For this project only** (recommended):
46
+
47
+ ```bash
48
+ claude mcp add cowrite -- npx -y @filipc77/cowrite@latest serve
49
+ ```
50
+
51
+ **For all projects** (user-level):
52
+
45
53
  ```bash
46
54
  claude mcp add -s user cowrite -- npx -y @filipc77/cowrite@latest serve
47
55
  ```
@@ -62,24 +70,14 @@ Pick a file and you'll see a live preview.
62
70
 
63
71
  Select any text in the preview. A **Comment** button appears — click it to open the comment form. Your text selection stays intact, so you can still copy-paste normally.
64
72
 
65
- ### 5. Start the background watcher (recommended)
66
-
67
- In your Claude Code session, type:
68
-
69
- ```
70
- /watch
71
- ```
72
-
73
- This starts a background watcher that handles comments as they arrive — without blocking your main conversation. You only need to do this once per session.
74
-
75
- ### 6. The agent handles your comments
73
+ ### 5. The agent picks up your comments
76
74
 
77
- Even without `/watch`, comments reach the agent through auto-installed hooks:
75
+ Comments are handled in two ways:
78
76
 
79
- - **`UserPromptSubmit` hook** — Whenever you send any message, pending comments are injected into the agent's context. The agent makes the change, replies in the browser preview, and resolves the comment.
80
- - **`Stop` hook** — When the agent finishes any task, it checks for pending comments before going idle. Catches comments that arrive while the agent is busy.
77
+ - **On your next message** — Whenever you send any message to the agent, pending comments are automatically included. The agent sees them, makes the changes, and resolves them. You don't need to mention the comments just send any message (even about something else) and the agent will handle them.
78
+ - **`/watch` (hands-free)** — Type `/watch` once per session to start a background watcher. The agent handles comments as soon as they arrive, without you needing to send a message. Your main conversation stays free for other work.
81
79
 
82
- ### 7. Auto-installed integration
80
+ ### 6. Auto-installed integration
83
81
 
84
82
  On first run, `cowrite serve` installs into your project's `.claude/` directory:
85
83
  - **Hooks** (`UserPromptSubmit` + `Stop`) — surface pending comments to the agent automatically
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@filipc77/cowrite",
3
- "version": "0.4.24",
3
+ "version": "0.4.26",
4
4
  "description": "Live commenting plugin for coding agent sessions",
5
5
  "type": "module",
6
6
  "bin": {