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 +11 -6
- package/package.json +5 -5
- package/skills/hunk-review/SKILL.md +1 -1
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"
|
|
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.
|
|
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.
|
|
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.
|
|
35
|
-
"hunkdiff-darwin-x64": "0.
|
|
36
|
-
"hunkdiff-linux-arm64": "0.
|
|
37
|
-
"hunkdiff-linux-x64": "0.
|
|
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
|
|
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.
|