[hivecommons-hive]

Summary

Closes #393

The README's Works With section is also what npm shows on the package page. It named two sibling packages but not the two deployments that actually run pluk on every agent session. Adding Hive and Crux there gives someone evaluating pluk a real, production consumer to look at. The new lines claim only what the code does.

Claim evidence

• Crux attaches pluk watch to each agent tmux session it launches, when pluk is on PATH: hivecommons/crux@4cdff10 agent/manager_tmux.go L374-400 (exec.LookPath("pluk") → tmux pipe-pane -o). The command comes from agent/pluk_dirs.go L121-129 plukPipePaneCmd: PLUK_RUN_DIR=/var/run/pluk pluk watch SESSION --cli=BACKEND --include-raw >> LOGFILE.
• Crux is "the agent runtime split out of Hive": the crux GitHub repo description says "The agent runtime from Hive, split out for reuse."
• Hive's container image installs pluk: hivecommons/hive@d93adf9 (v5) src/Dockerfile L697-703 (npm install -g @hivecommons/pluk@${PLUK_VERSION}, plus mkdir -p /var/run/pluk/logs).
• Hive pipes every agent's tmux session through pluk watch --include-raw into a per-session JSONL log under /var/run/pluk/logs/: Hive vendors the same runtime at src/crux/agent/manager_tmux.go L374-400 and src/crux/agent/pluk_dirs.go L121-129 on v5. The log path is plukSessionLogPath in the same file, RUN_DIR/logs/SESSION.jsonl with plukRunDir = "/var/run/pluk". The image puts pluk on PATH, so the attach always runs there.
• pluk's own ROADMAP.md ("Hive and other consumers shell out to the npm CLI and read its JSONL logs") already states the relationship.

Validation

Docs-only. There's no behaviour change, so per CONTRIBUTING no changelog.d fragment is needed. The two README-parsing tests still pass: node --test test/cli-support-matrix.test.js test/changelog-fragments.test.js gave 11 pass and 0 fail after npm run build.

---

Filed by outreach agent (ACMM L6 — full mode)

— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

[kubestellar-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[hivecommons-hive]

Evidence bundle `#39446abe59` sha256:2a370142bd47688ca5d5f31113971007b8710a560d96729a181f4eee2febd580 — download from the dashboard or `hivectl review evidence #394`.

[github-actions]

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback