hunkdiff 0.11.1 → 0.12.0-beta.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 CHANGED
@@ -20,7 +20,7 @@ Hunk is a review-first terminal diff viewer for agent-authored changesets, built
20
20
  <sub>Split view with sidebar and inline AI notes</sub>
21
21
  </td>
22
22
  <td width="40%" align="center">
23
- <img width="508" height="920" alt="image" src="https://github.com/user-attachments/assets/44c542a2-0a09-41cd-b264-fbd942e92f06" />
23
+ <img width="508" alt="image" src="https://github.com/user-attachments/assets/44c542a2-0a09-41cd-b264-fbd942e92f06" />
24
24
  <br />
25
25
  <sub>Stacked view and mouse-selectable menus</sub>
26
26
  </td>
@@ -33,6 +33,12 @@ Hunk is a review-first terminal diff viewer for agent-authored changesets, built
33
33
  npm i -g hunkdiff
34
34
  ```
35
35
 
36
+ Or with Homebrew:
37
+
38
+ ```bash
39
+ brew install modem-dev/tap/hunk
40
+ ```
41
+
36
42
  Requirements:
37
43
 
38
44
  - Node.js 18+
@@ -72,7 +78,7 @@ git diff --no-color | hunk patch - # review a patch from stdin
72
78
  ### Working with agents
73
79
 
74
80
  1. Open Hunk in another terminal with `hunk diff` or `hunk show`.
75
- 2. Load the Hunk review skill: [`skills/hunk-review/SKILL.md`](skills/hunk-review/SKILL.md).
81
+ 2. Tell your agent to add the skill file returned by `hunk skill path`.
76
82
  3. Ask your agent to use the skill against the live Hunk session.
77
83
 
78
84
  A good generic prompt is:
@@ -81,9 +87,6 @@ A good generic prompt is:
81
87
  Load the Hunk skill and use it for this review.
82
88
  ```
83
89
 
84
- > [!NOTE]
85
- > `hunk skill path` is available in Hunk 0.10.0 and newer. On older installs, load the skill from the repo path above.
86
-
87
90
  For the full live-session and `--agent-context` workflow guide, see [docs/agent-workflows.md](docs/agent-workflows.md).
88
91
 
89
92
  ## Feature comparison
@@ -162,7 +165,7 @@ diff-formatter = ":git"
162
165
 
163
166
  ### OpenTUI component
164
167
 
165
- Hunk also publishes `HunkDiffView` from `hunkdiff/opentui` for embedding the same diff renderer in your own OpenTUI app.
168
+ Hunk also publishes `HunkDiffView` and lower-level primitives from `hunkdiff/opentui` for embedding the same diff renderer in your own OpenTUI app.
166
169
 
167
170
  See [docs/opentui-component.md](docs/opentui-component.md) for install, API, and runnable examples.
168
171
 
@@ -174,6 +177,8 @@ Each example includes the exact command to run from the repository root.
174
177
 
175
178
  ## Contributing
176
179
 
180
+ 💬 _Chat with users/contributors on the [Modem Discord server](https://discord.gg/WZFjaP6Gt8)_
181
+
177
182
  For source setup, tests, packaging checks, and repo architecture, see [CONTRIBUTING.md](CONTRIBUTING.md).
178
183
 
179
184
  ## Sponsor
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hunkdiff",
3
- "version": "0.11.1",
3
+ "version": "0.12.0-beta.0",
4
4
  "description": "Desktop-inspired terminal diff viewer for understanding agent-authored changesets.",
5
5
  "bin": {
6
6
  "hunk": "./bin/hunk.cjs"
@@ -31,10 +31,10 @@
31
31
  "node": ">=18"
32
32
  },
33
33
  "optionalDependencies": {
34
- "hunkdiff-darwin-arm64": "0.11.1",
35
- "hunkdiff-darwin-x64": "0.11.1",
36
- "hunkdiff-linux-arm64": "0.11.1",
37
- "hunkdiff-linux-x64": "0.11.1"
34
+ "hunkdiff-darwin-arm64": "0.12.0-beta.0",
35
+ "hunkdiff-darwin-x64": "0.12.0-beta.0",
36
+ "hunkdiff-linux-arm64": "0.12.0-beta.0",
37
+ "hunkdiff-linux-x64": "0.12.0-beta.0"
38
38
  },
39
39
  "license": "MIT",
40
40
  "publishConfig": {
@@ -145,7 +145,7 @@ Guidelines:
145
145
  ## Common errors
146
146
 
147
147
  - **"No visible diff file matches ..."** -- the file is not in the loaded review. Check `context`, then `reload` if needed.
148
- - **"No active Hunk sessions"** -- ask the user to open Hunk in their terminal.
148
+ - **"No active Hunk sessions"** -- if Hunk is visibly running, localhost may be blocked by the agent sandbox; retry with network/sandbox escalation. Otherwise ask the user to open Hunk.
149
149
  - **"Multiple active sessions match"** -- pass `<session-id>` explicitly.
150
150
  - **"No active Hunk session matches session path ..."** -- for advanced split-path reloads, verify the live window `Path` via `hunk session get` or `list`, then use `--session-path`.
151
151
  - **"Pass the replacement Hunk command after `--`"** -- include `--` before the nested `diff` / `show` command.