@humwick/runner 0.0.0-stage → 0.130.0

package/plugins/claude/monitors/relay-monitor.ts

@@ -0,0 +1,58 @@
+import { relayEnv } from "@humwick/sdk/env";
+import type { Message } from "@humwick/sdk";
+import { claudeMonitorDeliveryPlan } from "../../../src/adapters/claude-delivery";
+import { claudeReadOnlyRelayContext, claudeRelayContext, workspaceDepsNoteFromEnv } from "../../../src/relay-instructions";
+
+const port = relayEnv(process.env, "AGENT_RELAY_RUNNER_PORT");
+if (!port) process.exit(0);
+
+let firstDelivery = true;
+const ws = new WebSocket(`ws://127.0.0.1:${port}/monitor`);
+
+ws.onmessage = (event) => {
+  const payload = parsePayload(String(event.data));
+  if (!payload || payload.type !== "message.deliver" || !Array.isArray(payload.messages)) return;
+  const messages = payload.messages as Message[];
+  // #1935 — the once-per-session context/workspace block is logged in the same synchronous tick as
+  // the message, so the harness batches both into ONE monitor event under a single size cap. Track
+  // the prefix length and hand it to the composer as reservedChars, so the over-limit stub gate
+  // accounts for the prefix and the first message can't be silently truncated behind it.
+  let reservedChars = 0;
+  if (firstDelivery) {
+    const contextBlock = relayEnv(process.env, "AGENT_RELAY_APPROVAL") === "read-only" ? claudeReadOnlyRelayContext() : claudeRelayContext();
+    const wsNote = workspaceDepsNoteFromEnv();
+    const prefix = [contextBlock, wsNote].filter(Boolean).join("\n\n");
+    console.log(prefix);
+    console.log("");
+    reservedChars = prefix.length + 2; // prefix + the two newlines separating it from the message
+    firstDelivery = false;
+  }
+  const plan = claudeMonitorDeliveryPlan(messages, {
+    reservedChars,
+    monitorLimited: true,
+    // #2310 — an over-cap must-keep section (memory context, self-resume continuation) is spilled
+    // byte-exact to the session scratch dir and represented by a small pointer instead of ever
+    // being raw-emitted for the harness to truncate. There is no supported way to emit more than
+    // one Monitor event per delivery cycle (the harness coalesces same-tick stdout into one
+    // event), so the pointer — not chunking — is what keeps the content loss-free.
+    spillDir: relayEnv(process.env, "AGENT_RELAY_SCRATCH_DIR"),
+  });
+  if (plan.events[0]) console.log(plan.events[0].text);
+  ws.send(JSON.stringify({
+    type: "message.delivered",
+    deliveryId: typeof payload.deliveryId === "string" ? payload.deliveryId : "",
+    // The control server's ack is intentionally the planned ids, never an optimistic input echo.
+    messageIds: plan.events[0]?.messageIds ?? [],
+  }));
+};
+
+ws.onerror = () => process.exit(1);
+
+function parsePayload(raw: string): Record<string, unknown> | null {
+  try {
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Record<string, unknown> : null;
+  } catch {
+    return null;
+  }
+}

package/plugins/claude/skills/disconnect/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: disconnect
+description: End the current Humwick pair session. Use when the user invokes /disconnect or asks to hang up, unpair, or disconnect from a paired agent.
+argument-hint: "[PAIR_ID]"
+allowed-tools: [Bash]
+---
+
+# Humwick Disconnect
+
+Run:
+
+```bash
+agent-relay /disconnect $ARGUMENTS
+```
+
+If no pair id is supplied, the CLI ends the active pair for this session. Report the result briefly.

package/plugins/claude/skills/label/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: label
+description: Read, set, or clear the current Humwick agent label. Use when the user invokes /label or asks to rename this relay agent.
+argument-hint: "[LABEL|--clear]"
+allowed-tools: [Bash]
+---
+
+# Humwick Label
+
+Run:
+
+```bash
+agent-relay /label $ARGUMENTS
+```
+
+Examples:
+
+```bash
+agent-relay /label backend-fixer
+agent-relay /label --clear
+```
+
+Report the new label or current label briefly.

package/plugins/claude/skills/message/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: message
+description: Send a normal Humwick message to another agent, label, tag, capability, policy, or broadcast target. Use when the user invokes /message or asks to send a one-off relay message.
+argument-hint: "<target> <message|--stdin|--body-file PATH> [--subject TEXT] [--channel NAME]"
+allowed-tools: [Bash]
+---
+
+# Humwick Message
+
+⚠️ **SECURITY — never inline the message body in the shell command.** A body with
+markdown backticks `` `like this` `` or `$(...)` would be shell-executed (command
+substitution) before `agent-relay` sees it — a command-injection vector (#1262),
+since the body may quote another agent's or a user's text. **Feed the body through
+stdin via a quoted heredoc** (the `'RELAY_EOF'` quotes disable all expansion):
+
+```bash
+agent-relay /message <target> --stdin <<'RELAY_EOF'
+Your message text. Backticks `bun run release` and $(anything) are delivered
+verbatim and are NOT executed.
+RELAY_EOF
+```
+
+Targets (the `<target>` positional) can be an agent id, `tag:`, `policy:`, `cap:`, or
+`broadcast`:
+
+```bash
+agent-relay /message codex --stdin <<'RELAY_EOF'
+Can you look at that failing action?
+RELAY_EOF
+
+agent-relay /message tag:backend --stdin <<'RELAY_EOF'
+Does anyone see the regression?
+RELAY_EOF
+```
+
+For a message you have already staged in a file, use `--body-file PATH` instead.
+
+**Do NOT** build `agent-relay /message <target> "…body…"` with the body inside quotes.
+
+Report the sent message id briefly.

package/plugins/claude/skills/pair/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: pair
+description: Start, inspect, accept, reject, or send messages in an Humwick two-agent pair session. Use when the user invokes /pair or asks to pair this agent with Codex, Claude, or another relay agent.
+argument-hint: "<target|status|accept|reject|send> [args]"
+allowed-tools: [Bash]
+---
+
+# Humwick Pair
+
+Run the Humwick CLI with the user's arguments:
+
+```bash
+agent-relay /pair $ARGUMENTS
+```
+
+Use this for pair-session commands such as:
+
+```bash
+agent-relay /pair codex "Debug flaky tests"
+agent-relay /pair status
+agent-relay /pair accept PAIR_ID
+agent-relay /pair reject PAIR_ID
+agent-relay /pair send PAIR_ID --stdin <<'EOF'
+What do you see?
+EOF
+```
+
+Report the command output briefly. If the CLI cannot detect this session's agent id, rerun with `--agent AGENT_ID` or `--from AGENT_ID` using the Humwick ID shown in session context.
+
+Always pass the message body via a quoted heredoc into `--stdin` (or `--body-file PATH`), never inline in the shell command: backticks / `$(...)` in a body are otherwise command-substituted by your shell before `agent-relay` runs (#1263).

package/plugins/claude/skills/react/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: react
+description: Add or remove an Humwick reaction on a message. Use for lightweight acknowledgement, approval, thanks, or good-job responses when no text reply is needed.
+argument-hint: "<messageId> <emoji> [--remove]"
+allowed-tools: [Bash]
+---
+
+# Humwick React
+
+Run:
+
+```bash
+agent-relay /react $ARGUMENTS
+```
+
+Use reactions instead of text when the message only needs lightweight acknowledgement, approval, thanks, or "good job".
+
+Do not use reactions when the sender asked a question, gave a new task, reported a bug, or needs a result in text.

package/plugins/claude/skills/read-message/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: read-message
+description: Fetch a full Humwick message by ID, including full body, attachments, metadata, and thread context. Use when a delivered Relay preview is truncated or when the user asks to inspect a relay message.
+argument-hint: "<messageId> [--json|--body]"
+allowed-tools: [Bash]
+---
+
+# Humwick Read Message
+
+Run:
+
+```bash
+agent-relay get-message $ARGUMENTS
+```
+
+Useful forms:
+
+```bash
+agent-relay get-message 206
+agent-relay get-message 206 --json
+agent-relay get-message 206 --body
+```
+
+Use `--body` when you only need the complete message text. Use `--json` when attachments, metadata, or thread context matter.

package/plugins/claude/skills/reply/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: reply
+description: Reply to an Humwick message by ID. Auto-routes to the sender and inherits channel context — no target needed. Use when the user invokes /reply or asks to reply to a specific relay message, especially with stdin/file for long replies.
+argument-hint: "<messageId> <message|--stdin|--body-file PATH>"
+allowed-tools: [Bash]
+---
+
+# Humwick Reply
+
+⚠️ **SECURITY — never inline the reply body in the shell command.** Your shell runs
+the command you type, so a body containing markdown backticks `` `like this` `` or
+`$(...)` would be executed as a shell command *before* `agent-relay` ever sees it
+(command substitution). This is a real command-injection vector (#1262): the body may
+quote another agent's or a user's text. **Always feed the body through stdin via a
+quoted heredoc**, which disables all shell expansion and delivers the body verbatim.
+
+Run (safe — quoted `'RELAY_EOF'` delimiter means no expansion, no substitution):
+
+```bash
+agent-relay /reply <messageId> --stdin <<'RELAY_EOF'
+Your reply text here. Backticks `bun run release` and $(anything) are delivered
+verbatim and are NOT executed.
+RELAY_EOF
+```
+
+The server auto-routes the reply to the original sender and inherits the channel
+(Telegram, Slack, etc.) if applicable. No target or channel ID needed.
+
+For a reply you have already staged in a file, use `--body-file` instead:
+
+```bash
+agent-relay /reply <messageId> --body-file .agent-relay/sessions/$AGENT_RELAY_ID/tmp/reply.md
+```
+
+The relay creates that per-session scratch dir for you (git-ignored locally), so
+staging there never pollutes the working tree and never collides with other agents.
+No cleanup needed — the dir is reaped when your session ends. Oversized replies are
+automatically uploaded as an Humwick artifact and sent as an attached concise reply.
+
+**Do NOT** build `agent-relay /reply <id> "…body…"` with the body inside quotes — the
+heredoc `--stdin` form above is the only safe way to pass free text.
+
+Do not send a separate Relay follow-up that only confirms the reply was sent. The CLI
+output is enough local confirmation.

package/plugins/claude/skills/send-claimable/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: send-claimable
+description: Send a claimable Humwick work item so one matching agent can claim and handle it. Use when the user invokes /send-claimable or wants to enqueue work for another agent.
+argument-hint: "<target> <message|--stdin|--body-file PATH> [--subject TEXT] [--channel NAME]"
+allowed-tools: [Bash]
+---
+
+# Humwick Send Claimable
+
+⚠️ **SECURITY — never inline the work-item body in the shell command.** A body with
+markdown backticks `` `like this` `` or `$(...)` would be shell-executed (command
+substitution) before `agent-relay` sees it — a command-injection vector (#1262).
+**Feed the body through stdin via a quoted heredoc** (the `'RELAY_EOF'` quotes disable
+all expansion, delivering the body verbatim):
+
+```bash
+agent-relay /send-claimable <target> --stdin <<'RELAY_EOF'
+Describe the work item here. Backticks `bun run release` and $(anything) are
+delivered verbatim and are NOT executed.
+RELAY_EOF
+```
+
+Targets can be an agent id, `tag:`, `cap:`, or `policy:`:
+
+```bash
+agent-relay /send-claimable tag:backend --stdin <<'RELAY_EOF'
+Fix the failing API test
+RELAY_EOF
+
+agent-relay /send-claimable cap:review --stdin <<'RELAY_EOF'
+Review the migration patch
+RELAY_EOF
+```
+
+For a work item you have already staged in a file, use `--body-file PATH` instead.
+
+**Do NOT** build `agent-relay /send-claimable <target> "…body…"` with the body inside quotes.
+
+Report the sent claimable message id briefly.

package/plugins/claude/skills/slice-first/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: slice-first
+description: Frame and prove a thin end-to-end feature slice before planning hardening. Use for new feature coordination or stage decisions in any project.
+---
+
+# Slice first
+
+Use the current project's instructions and configured validation/deployment gates,
+including its “How to validate in THIS project” brief or `.agent-relay/land-gates.json`.
+Choose the proof's location and runtime in that project; no particular repo is required.
+
+| Stage | Required result |
+|---|---|
+| frame | Write and commit the executable proof FIRST; it fails for the right reason. Then a slice spec, max one page: path, proof command, allowed shortcuts, fixed v1 bar, unknowns, harden budget (default 6 Tasks). |
+| slice | One builder, one branch, all layers, flag off by default. Proof passes on a deployed/ephemeral instance and a different agent reproduces it. |
+| harden | Only after independent proof passes: plan small changes to the working feature; re-run the proof at every delivery. |
+| v1 | Fixed bar met; enable flag; file remaining work as future issues outside the DAG. |
+| closed | Record closure. |
+
+Coordinator owns stages, scope ledger and budget; record stage decisions on the spec
+Task. Changing the bar or exceeding the budget needs operator approval. A blocked
+slice returns to frame. Never create or spawn harden Tasks before the proof Task is
+done with `slice-proof: pass`; dependencies alone do not prevent dispatch.
+
+Design writes proof then spec, no full design. Builder declares each slice shortcut
+in delivery risks. QA reproduces independently. Review blocks only on the stage's
+bar: declared slice shortcuts may pass; unmet harden/v1 criteria block. Outside-bar
+findings are future work.
+
+`slice-proof` supplements project gates; it never replaces them. Record command,
+revision and instance with the result. For coordinators building a plan, load
+[references/plan-recipe.md](references/plan-recipe.md). Other roles need no recipe.

package/plugins/claude/skills/slice-first/references/plan-recipe.md

@@ -0,0 +1,46 @@
+# Plan recipe (coordinator only)
+
+1. **Frame.** `relay_plan_create { title:"<feature>", acceptance:[{ id, text, check?:{ path }|{ command } }] }`.
+   Acceptance is required: the plan's own bar (the design doc's deliverables, deletions and
+   acceptance commands), one checkable item each. Then create and bind the spec Task:
+   `relay_task_create { intent, issueRefs:["#<feature>"] }` →
+   `relay_plan_add_node { planId, node:{ id:"spec", label:"Slice spec", lane:"frame", refs:{ taskId:<spec> } } }`.
+   Record the fixed v1 bar and budget on this Task; spawn `software-design` on it.
+2. **Slice.** Create the build Task (normal landing Task) and the proof Task. The proof
+   Task must not land: `relay_task_create { intent:"Independent slice proof",
+   doneWhen:"delivered", dispatch:{ type:"review" }, context:"<proof command>; <instance>" }`.
+   Add both as nodes (lane `slice`, `refs:{ taskId }`) and edges `spec→build`, `build→proof`
+   (`relay_plan_add_edge { planId, from, to }`: `to` depends on `from`; edges between bound
+   nodes become Task dependencies). Spawn a `worker` on `build`; when its project delivery/deployment
+   gates pass, spawn `QA` on `proof`.
+3. **Gate.** The prover delivers the proof Task; that closes it `done` with no land attempt
+   because it is a delivered review Task. `relay_task_record_gate` alone does not finish it,
+   so its harden dependents stay on an open upstream.
+   - Pass: `relay_task_deliver { disposition:"complete", summary, gates:{ other:[{ name:"slice-proof", status:"pass", detail:"<command> @ <sha> on <instance>" }] } }`
+   - Fail: `relay_task_deliver { disposition:"failed", summary, reason:"<blocker>", gates:{ other:[{ name:"slice-proof", status:"fail", detail }] } }`
+
+   Fail → frame again (new spec revision, same plan). Pass → verify the proof Task is
+   `done` with `slice-proof: pass`, then record the stage on the spec Task:
+   `relay_task_memory_append_decision { taskId:<spec>, decision:"stage: harden" }`.
+4. **Harden.** Only now add harden nodes (lane `harden`, bound to their Tasks), each with
+   an edge `proof→<node>`, up to the budget. Each harden builder delivers normally and adds
+   the proof re-run: `relay_task_deliver { disposition:"complete", summary, commits,
+   idempotencyKey, gates:{ test:{ status:"pass" }, other:[{ name:"slice-proof", status:"pass" }] } }`.
+5. **Conformance.** When every node lands the plan reads `completion:"conformance-pending"`,
+   not done, and you get a `plan.conformance-pending` notice. Fetch, check each acceptance item
+   on the main tip (or spawn a fresh agent to audit it), then
+   `relay_plan_conformance { planId, mainSha:<origin/main tip>, items:[{ id, status:"met"|"unmet", note? }] }`.
+   A gap files one bound Task per unmet item and reopens the plan; repeat after they land.
+   Only a pass makes the plan `done`.
+6. **v1/closed.** Bar met → flag on, file "future" issues, record `stage: v1`;
+   after closure, record `stage: closed` and archive the plan.
+
+Before spawning a harden builder, read `relay_task_get { taskId:<harden>, verbose:true }`
+for `dependsOn`, then `relay_task_get { taskId:<proof>, verbose:true }`; require
+`status:"done"` and `slice-proof` with `status:"pass"`. Relay records dependencies;
+the coordinator enforces dispatch order. Validate with the project's own commands
+from its spawn brief/config; the proof is an additional gate.
+
+Check gate order any time with `relay_plan_get { planId, mode:"lean" }`: every
+`harden` node must have `proof` upstream, and no harden node may exist while the proof
+Task is not complete with a passing `slice-proof` gate.

package/plugins/claude/skills/status/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: status
+description: Show Humwick status for this session, including relay health, current agent id, label, tags, readiness, and active pair state. Use when the user invokes /status or asks for relay connection status.
+argument-hint: "[--json]"
+allowed-tools: [Bash]
+---
+
+# Humwick Status
+
+Run:
+
+```bash
+agent-relay /status $ARGUMENTS
+```
+
+Summarize the current relay connection, agent identity, label, tags, and active pair state.

package/plugins/claude/skills/tags/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: tags
+description: List or update Humwick tags for the current session. Use when the user invokes /tags or asks to set, add, remove, or inspect relay tags.
+argument-hint: "[TAG ...|--list|--add TAGS|--remove TAGS]"
+allowed-tools: [Bash]
+---
+
+# Humwick Tags
+
+Run:
+
+```bash
+agent-relay /tags $ARGUMENTS
+```
+
+Examples:
+
+```bash
+agent-relay /tags
+agent-relay /tags backend tests urgent
+agent-relay /tags --add backend,tests
+agent-relay /tags --remove urgent
+```
+
+Report the resulting tags briefly.

package/plugins/claude/skills/task/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: agent-relay-task
+description: Use Humwick Task tools to create, update, and document durable work records. Use when coordinating multi-step work or when your brief was spawned from a Task.
+---
+
+# Humwick Task
+
+Use Relay Task tools for durable work tracking instead of burying state in chat.
+
+Coordinators:
+
+- Create a Task before multi-step work with `relay_task_create`.
+- Set `intent`, `complexity`, and useful `context`; add `doneWhen`, `dispatch`, refs, or dependencies when they clarify routing.
+- Spawn workers from the Task so they inherit the Task context.
+
+Workers:
+
+- Use `relay_task_set_status` as work moves through `in_progress`, `blocked`, `done`, `failed`, or `canceled`.
+- Use `relay_task_memory_replace_working_state` for current progress a retry agent needs.
+- Use `relay_task_memory_append_decision` for durable choices and rationale.
+- Use `relay_task_memory_append_ruled_out` for dead ends, failed approaches, and why they were rejected.
+
+Useful reads and updates:
+
+- `relay_task_get` and `relay_task_history` inspect the Task and audit timeline.
+- `relay_task_update` refreshes intent, context, latest steer, doneWhen, complexity, or dispatch.
+- `relay_task_record_gate` records tests, typecheck, docs, smoke, and other quality gates.
+- `relay_task_dispatch` maps Task shape to a concrete spawn and launches it bound to the Task (shared spawn path). Idempotent retry needs a caller-supplied spawnRequestId, as with relay_spawn_agent.

package/plugins/claude-output-style/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "agent-relay-output-style",
+  "description": "Suppress Claude Code's redundant default output-style instructions for Relay-managed sessions",
+  "version": "0.129.23"
+}

package/plugins/claude-output-style/output-styles/agent-relay.md

@@ -0,0 +1,5 @@
+---
+name: Agent Relay
+description: Relay-managed sessions provide their communication rules through the agent profile.
+force-for-plugin: true
+---

package/plugins/codex/skills/disconnect/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: disconnect
+description: End the current Humwick pair session. Use when the user invokes /disconnect or asks to hang up, unpair, or disconnect from a paired agent.
+argument-hint: "[PAIR_ID]"
+---
+
+# Humwick Disconnect
+
+Run:
+
+```bash
+agent-relay /disconnect $ARGUMENTS
+```
+
+If no pair id is supplied, the CLI ends the active pair for this session. Report the result briefly.

package/plugins/codex/skills/guide/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: guide
+description: Show the Humwick command guide for coding agents. Use when the user invokes /guide or asks how to use Humwick messaging, replies, pair sessions, labels, tags, targets, or claimable work.
+argument-hint: ""
+---
+
+# Humwick Guide
+
+Run:
+
+```bash
+agent-relay /guide
+```
+
+Use this before guessing Relay commands. The guide explains reply, message, pair, status, label, tag, target, and claimable-work commands.

package/plugins/codex/skills/label/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: label
+description: Read, set, or clear the current Humwick agent label. Use when the user invokes /label or asks to rename this relay agent.
+argument-hint: "[LABEL|--clear]"
+---
+
+# Humwick Label
+
+Run:
+
+```bash
+agent-relay /label $ARGUMENTS
+```
+
+Examples:
+
+```bash
+agent-relay /label backend-fixer
+agent-relay /label --clear
+```
+
+Report the new label or current label briefly.

package/plugins/codex/skills/message/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: message
+description: Send a normal Humwick message to another agent, label, tag, capability, policy, or broadcast target. Use when the user invokes /message or asks to send a one-off relay message.
+argument-hint: "<target> <message|--stdin|--body-file PATH> [--subject TEXT] [--channel NAME]"
+allowed-tools: [Bash]
+---
+
+# Humwick Message
+
+⚠️ **SECURITY — never inline the message body in the shell command.** A body with
+markdown backticks `` `like this` `` or `$(...)` would be shell-executed (command
+substitution) before `agent-relay` sees it — a command-injection vector (#1262),
+since the body may quote another agent's or a user's text. **Feed the body through
+stdin via a quoted heredoc** (the `'RELAY_EOF'` quotes disable all expansion):
+
+```bash
+agent-relay /message <target> --stdin <<'RELAY_EOF'
+Your message text. Backticks `bun run release` and $(anything) are delivered
+verbatim and are NOT executed.
+RELAY_EOF
+```
+
+Targets (the `<target>` positional) can be an agent id, `tag:`, `policy:`, `cap:`, or
+`broadcast`:
+
+```bash
+agent-relay /message codex --stdin <<'RELAY_EOF'
+Can you look at that failing action?
+RELAY_EOF
+
+agent-relay /message tag:backend --stdin <<'RELAY_EOF'
+Does anyone see the regression?
+RELAY_EOF
+```
+
+For a message you have already staged in a file, use `--body-file PATH` instead.
+
+**Do NOT** build `agent-relay /message <target> "…body…"` with the body inside quotes.
+
+Report the sent message id briefly.

package/plugins/codex/skills/pair/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: pair
+description: Start, inspect, accept, reject, or send messages in an Humwick two-agent pair session. Use when the user invokes /pair or asks to pair this agent with Codex, Claude, or another relay agent.
+argument-hint: "<target|status|accept|reject|send> [args]"
+---
+
+# Humwick Pair
+
+Run the Humwick CLI with the user's arguments:
+
+```bash
+agent-relay /pair $ARGUMENTS
+```
+
+Use this for pair-session commands such as:
+
+```bash
+agent-relay /pair codex "Debug flaky tests"
+agent-relay /pair status
+agent-relay /pair accept PAIR_ID
+agent-relay /pair reject PAIR_ID
+agent-relay /pair send PAIR_ID --stdin <<'EOF'
+What do you see?
+EOF
+```
+
+Report the command output briefly. If the CLI cannot detect this session's agent id, rerun with `--agent AGENT_ID` or `--from AGENT_ID` using the Humwick ID shown in session context.
+
+Always pass the message body via a quoted heredoc into `--stdin` (or `--body-file PATH`), never inline in the shell command: backticks / `$(...)` in a body are otherwise command-substituted by your shell before `agent-relay` runs (#1263).

package/plugins/codex/skills/react/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: react
+description: Add or remove an Humwick reaction on a message. Use for lightweight acknowledgement, approval, thanks, or good-job responses when no text reply is needed.
+argument-hint: "<messageId> <emoji> [--remove]"
+---
+
+# Humwick React
+
+Run:
+
+```bash
+agent-relay /react $ARGUMENTS
+```
+
+Use reactions instead of text when the message only needs lightweight acknowledgement, approval, thanks, or "good job".
+
+Do not use reactions when the sender asked a question, gave a new task, reported a bug, or needs a result in text.

package/plugins/codex/skills/read-message/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: read-message
+description: Fetch a full Humwick message by ID, including full body, attachments, metadata, and thread context. Use when a delivered Relay preview is truncated or when the user asks to inspect a relay message.
+argument-hint: "<messageId> [--json|--body]"
+---
+
+# Humwick Read Message
+
+Run:
+
+```bash
+agent-relay get-message $ARGUMENTS
+```
+
+Useful forms:
+
+```bash
+agent-relay get-message 206
+agent-relay get-message 206 --json
+agent-relay get-message 206 --body
+```
+
+Use `--body` when you only need the complete message text. Use `--json` when attachments, metadata, or thread context matter.