agent-relay-codex 0.4.17 → 0.4.18

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-codex",
-  "version": "0.4.17",
+  "version": "0.4.18",
   "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.18",
   "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.