agent-relay-codex 0.4.17 → 0.4.19

package/README.md

@@ -134,6 +134,25 @@ agent-relay-codex uninstall --purge  # also remove runtime state and PATH entrie
 
 Message delivery adapts to thread state: `turn/start` when idle, `turn/steer` when active, `turn/interrupt` for urgent messages.
 
+## Command Skills
+
+The Codex plugin ships command skills for Agent Relay slash commands:
+
+```bash
+/pair codex "Debug flaky tests"
+/message codex "Can you look at that failing action?"
+/send-claimable tag:backend "Please claim and fix the failing API test"
+/disconnect
+/status
+/label backend-fixer
+/tags backend tests urgent
+```
+
+If another installed skill uses the same name, invoke the prefixed form such as
+`/agent-relay:pair`, `/agent-relay:message`,
+`/agent-relay:send-claimable`, `/agent-relay:disconnect`,
+`/agent-relay:status`, `/agent-relay:label`, or `/agent-relay:tags`.
+
 ## Development
 
 ```bash

package/bin/agent-relay-codex.ts

@@ -118,7 +118,15 @@ function isAgentRelaySessionStartCommand(command: string): boolean {
   return /agent-relay.*hooks\/session-start\.ts/.test(command);
 }
 
-function removeAgentRelaySessionStartToml(input: string): string {
+function isSessionStartGroupHeader(header: string | null | undefined): boolean {
+  return header?.trim() === "[[hooks.SessionStart]]";
+}
+
+function isSessionStartHookHeader(header: string | null | undefined): boolean {
+  return header?.trim() === "[[hooks.SessionStart.hooks]]";
+}
+
+export function removeAgentRelaySessionStartToml(input: string): string {
   const lines = input.split(/\r?\n/);
   const blocks: Array<{ header: string | null; text: string }> = [];
 
@@ -136,15 +144,26 @@ function removeAgentRelaySessionStartToml(input: string): string {
   let output = "";
   for (let index = 0; index < blocks.length; ) {
     const block = blocks[index];
-    if (block?.header?.startsWith("[[hooks.SessionStart")) {
-      const group: typeof blocks = [];
-      while (index < blocks.length && blocks[index]?.header?.startsWith("[[hooks.SessionStart")) {
-        group.push(blocks[index]!);
+    if (isSessionStartGroupHeader(block?.header)) {
+      const group = block!;
+      const hooks: typeof blocks = [];
+      index += 1;
+      while (index < blocks.length && isSessionStartHookHeader(blocks[index]?.header)) {
+        hooks.push(blocks[index]!);
         index += 1;
       }
 
-      const groupText = group.map((block) => block.text).join("\n");
-      if (!isAgentRelaySessionStartCommand(groupText)) output += `${groupText}\n`;
+      const keptHooks = hooks.filter((hook) => !isAgentRelaySessionStartCommand(hook.text));
+      const groupIsAgentRelay = isAgentRelaySessionStartCommand(group.text) || (hooks.length > 0 && keptHooks.length === 0);
+      if (!groupIsAgentRelay || keptHooks.length > 0) {
+        output += `${group.text}\n`;
+        for (const hook of keptHooks) output += `${hook.text}\n`;
+      }
+      continue;
+    }
+
+    if (isSessionStartHookHeader(block?.header) && isAgentRelaySessionStartCommand(block?.text ?? "")) {
+      index += 1;
       continue;
     }
 
@@ -987,7 +1006,9 @@ async function main(): Promise<void> {
   return start(command ? [command, ...args] : []);
 }
 
-main().catch((error) => {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exit(1);
-});
+if (import.meta.main) {
+  main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-codex",
-  "version": "0.4.17",
+  "version": "0.4.19",
   "description": "Codex integration for Agent Relay — auto-registers sessions as agents and enables inter-agent messaging",
   "type": "module",
   "bin": {

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "0.4.16",
+  "version": "0.4.19",
   "description": "Agent Relay integration for Codex sessions",
   "author": {
     "name": "Edin Mujkanovic"

package/plugin/skills/agent-relay/SKILL.md

@@ -29,13 +29,16 @@ Targets can be an agent id, `broadcast`, `cap:<capability>`, `tag:<tag>`, or `la
 Use pair sessions for focused, two-agent live collaboration. Pairing is exclusive: one agent can have only one pending or active pair.
 
 When the user types a slash-style relay instruction such as `/pair codex`,
-`/pair status`, `/pair send <pair-id> ...`, `/disconnect`, `/status`,
-`/label ...`, or `/tags ...`, run the matching `agent-relay` CLI command
-instead of explaining the API. The CLI auto-detects the current agent id from
-provider state in normal plugin installs.
+`/message codex ...`, `/send-claimable tag:backend ...`, `/pair status`,
+`/pair send <pair-id> ...`, `/disconnect`, `/status`, `/label ...`, or
+`/tags ...`, run the matching `agent-relay` CLI command instead of explaining
+the API. The CLI auto-detects the current agent id from provider state in normal
+plugin installs.
 
 ```bash
 agent-relay /pair codex "Debug flaky tests"
+agent-relay /message codex "Can you look at that failing action?"
+agent-relay /send-claimable tag:backend "Please claim and fix the failing API test"
 agent-relay /pair status
 agent-relay /pair send PAIR_ID "What do you see?"
 agent-relay /disconnect

package/plugin/skills/disconnect/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: disconnect
+description: End the current Agent Relay 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]
+---
+
+# Agent Relay 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/plugin/skills/label/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: label
+description: Read, set, or clear the current Agent Relay agent label. Use when the user invokes /label or asks to rename this relay agent.
+argument-hint: "[LABEL|--clear]"
+allowed-tools: [Bash]
+---
+
+# Agent Relay 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/plugin/skills/message/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: message
+description: Send a normal Agent Relay message to another agent, label, tag, capability, or broadcast target. Use when the user invokes /message or asks to send a one-off relay message.
+argument-hint: "<target> <message> [--subject TEXT] [--channel NAME]"
+allowed-tools: [Bash]
+---
+
+# Agent Relay Message
+
+Run:
+
+```bash
+agent-relay /message $ARGUMENTS
+```
+
+Examples:
+
+```bash
+agent-relay /message codex "Can you look at that failing action?"
+agent-relay /message tag:backend "Does anyone see the regression?"
+agent-relay /message broadcast "Standup in five minutes"
+```
+
+Report the sent message id briefly.

package/plugin/skills/pair/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: pair
+description: Start, inspect, accept, reject, or send messages in an Agent Relay 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]
+---
+
+# Agent Relay Pair
+
+Run the Agent Relay 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 "What do you see?"
+```
+
+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 Agent Relay ID shown in session context.

package/plugin/skills/send-claimable/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: send-claimable
+description: Send a claimable Agent Relay 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> [--subject TEXT] [--channel NAME]"
+allowed-tools: [Bash]
+---
+
+# Agent Relay Send Claimable
+
+Run:
+
+```bash
+agent-relay /send-claimable $ARGUMENTS
+```
+
+Examples:
+
+```bash
+agent-relay /send-claimable codex "Claim this and inspect the failing action"
+agent-relay /send-claimable tag:backend "Fix the failing API test"
+agent-relay /send-claimable cap:review "Review the migration patch"
+```
+
+Report the sent claimable message id briefly.

package/plugin/skills/status/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: status
+description: Show Agent Relay 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]
+---
+
+# Agent Relay Status
+
+Run:
+
+```bash
+agent-relay /status $ARGUMENTS
+```
+
+Summarize the current relay connection, agent identity, label, tags, and active pair state.

package/plugin/skills/tags/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: tags
+description: List or update Agent Relay 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]
+---
+
+# Agent Relay 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.