hunkdiff 0.11.0 → 0.12.0-beta.0

package/README.md

@@ -20,7 +20,7 @@ Hunk is a review-first terminal diff viewer for agent-authored changesets, built
      <sub>Split view with sidebar and inline AI notes</sub>
    </td>
    <td width="40%" align="center">
-     <img width="508" height="920" alt="image" src="https://github.com/user-attachments/assets/44c542a2-0a09-41cd-b264-fbd942e92f06" />
+     <img width="508" alt="image" src="https://github.com/user-attachments/assets/44c542a2-0a09-41cd-b264-fbd942e92f06" />
      <br />
      <sub>Stacked view and mouse-selectable menus</sub>
    </td>
@@ -33,6 +33,12 @@ Hunk is a review-first terminal diff viewer for agent-authored changesets, built
 npm i -g hunkdiff
 ```
 
+Or with Homebrew:
+
+```bash
+brew install modem-dev/tap/hunk
+```
+
 Requirements:
 
 - Node.js 18+
@@ -59,15 +65,7 @@ hunk show HEAD~1               # review an earlier commit
 
 ### Working with Jujutsu
 
-Set `vcs = "jj"` in config to use the same `hunk diff [revset]` and `hunk show [revset]` commands with Jujutsu revsets instead. When `vcs` is unset, Hunk uses Git.
-
-To use hunk as jj's pager, run `jj config edit --user` and update:
-
-```toml
-[ui]
-pager = ["hunk", "pager"]
-diff-formatter = ":git"
-```
+Hunk auto-detects Jujutsu checkouts, so `hunk diff [revset]` and `hunk show [revset]` use jj revsets inside a jj workspace. To override VCS detection, set `vcs = "git"` or `vcs = "jj"` in [config](#config).
 
 ### Working with raw files and patches
 
@@ -80,7 +78,7 @@ git diff --no-color | hunk patch -          # review a patch from stdin
 ### Working with agents
 
 1. Open Hunk in another terminal with `hunk diff` or `hunk show`.
-2. Load the Hunk review skill: [`skills/hunk-review/SKILL.md`](skills/hunk-review/SKILL.md).
+2. Tell your agent to add the skill file returned by `hunk skill path`.
 3. Ask your agent to use the skill against the live Hunk session.
 
 A good generic prompt is:
@@ -89,9 +87,6 @@ A good generic prompt is:
 Load the Hunk skill and use it for this review.
 ```
 
-> [!NOTE]
-> `hunk skill path` is available in Hunk 0.10.0 and newer. On older installs, load the skill from the repo path above.
-
 For the full live-session and `--agent-context` workflow guide, see [docs/agent-workflows.md](docs/agent-workflows.md).
 
 ## Feature comparison
@@ -158,9 +153,19 @@ git config --global alias.hdiff "-c core.pager=\"hunk pager\" diff"
 git config --global alias.hshow "-c core.pager=\"hunk pager\" show"
 ```
 
+### Jujutsu pager integration
+
+To use Hunk as jj's pager, run `jj config edit --user` and update:
+
+```toml
+[ui]
+pager = ["hunk", "pager"]
+diff-formatter = ":git"
+```
+
 ### OpenTUI component
 
-Hunk also publishes `HunkDiffView` from `hunkdiff/opentui` for embedding the same diff renderer in your own OpenTUI app.
+Hunk also publishes `HunkDiffView` and lower-level primitives from `hunkdiff/opentui` for embedding the same diff renderer in your own OpenTUI app.
 
 See [docs/opentui-component.md](docs/opentui-component.md) for install, API, and runnable examples.
 
@@ -172,6 +177,8 @@ Each example includes the exact command to run from the repository root.
 
 ## Contributing
 
+💬 _Chat with users/contributors on the [Modem Discord server](https://discord.gg/WZFjaP6Gt8)_
+
 For source setup, tests, packaging checks, and repo architecture, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Sponsor

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hunkdiff",
-  "version": "0.11.0",
+  "version": "0.12.0-beta.0",
   "description": "Desktop-inspired terminal diff viewer for understanding agent-authored changesets.",
   "bin": {
     "hunk": "./bin/hunk.cjs"
@@ -31,10 +31,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "hunkdiff-darwin-arm64": "0.11.0",
-    "hunkdiff-darwin-x64": "0.11.0",
-    "hunkdiff-linux-arm64": "0.11.0",
-    "hunkdiff-linux-x64": "0.11.0"
+    "hunkdiff-darwin-arm64": "0.12.0-beta.0",
+    "hunkdiff-darwin-x64": "0.12.0-beta.0",
+    "hunkdiff-linux-arm64": "0.12.0-beta.0",
+    "hunkdiff-linux-x64": "0.12.0-beta.0"
   },
   "license": "MIT",
   "publishConfig": {

package/skills/hunk-review/SKILL.md

@@ -145,7 +145,7 @@ Guidelines:
 ## Common errors
 
 - **"No visible diff file matches ..."** -- the file is not in the loaded review. Check `context`, then `reload` if needed.
-- **"No active Hunk sessions"** -- ask the user to open Hunk in their terminal.
+- **"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.
 - **"Multiple active sessions match"** -- pass `<session-id>` explicitly.
 - **"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`.
 - **"Pass the replacement Hunk command after `--`"** -- include `--` before the nested `diff` / `show` command.