pair-mode 0.2.1 → 0.3.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+  "name": "pair-mode",
+  "version": "0.3.0",
+  "description": "Hold every proposed edit, annotate the diff line by line, and hand the notes back to the agent.",
+  "author": {
+    "name": "ofrusch",
+    "email": "owenc343@gmail.com"
+  },
+  "homepage": "https://github.com/oFrusch/pair-mode#readme",
+  "repository": "https://github.com/oFrusch/pair-mode.git",
+  "license": "MIT"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,29 @@
+{
+  "name": "pair-mode",
+  "version": "0.3.0",
+  "description": "Hold every proposed edit, annotate the diff line by line, and hand the notes back to the agent.",
+  "author": {
+    "name": "ofrusch",
+    "url": "https://github.com/oFrusch"
+  },
+  "homepage": "https://github.com/oFrusch/pair-mode#readme",
+  "license": "MIT",
+  "keywords": [
+    "code-review",
+    "diff",
+    "hooks",
+    "pair-programming",
+    "terminal"
+  ],
+  "hooks": "./hooks/codex.json",
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Pair Mode",
+    "shortDescription": "Review each proposed edit before it lands",
+    "longDescription": "Pair mode intercepts every proposed edit. It renders the diff in a terminal pane or a browser page, collects notes anchored to line numbers, then holds the edit and returns those notes to the agent. A review you close with no notes applies the edit as proposed.",
+    "developerName": "ofrusch",
+    "category": "Engineering",
+    "websiteURL": "https://github.com/oFrusch/pair-mode",
+    "logo": "./assets/duck.png"
+  }
+}

package/README.md

@@ -21,6 +21,28 @@ npm install -g pair-mode
 pair-mode setup
 ```
 
+### Or install it as a plugin
+
+A plugin resolves its own path at runtime, so it needs no global install and no setup step.
+
+Claude Code:
+
+```
+/plugin marketplace add oFrusch/pair-mode
+/plugin install pair-mode
+```
+
+Codex:
+
+```
+codex plugin marketplace add oFrusch/pair-mode
+codex plugin add pair-mode@pair-mode
+```
+
+The plugin registers the hook and the `/pair` command for that one CLI. Run
+`npm install -g pair-mode` as well if you want the `pair-mode` command on your PATH, which
+`pair-mode watch` and `pair-mode config` need.
+
 Install pair-mode globally before you run setup. Setup writes the install path into each CLI's config as an absolute path. `npx pair-mode setup` runs from a package cache that npm later prunes, which would leave every hook pointing at a deleted file. Setup detects that case and stops.
 
 The setup command detects the CLIs and multiplexers on your machine, registers the

package/commands/pair.md

@@ -0,0 +1,18 @@
+---
+description: Toggle pair mode. Every proposed edit opens in the pair review pane for line annotation.
+allowed-tools: Bash(node:*)
+---
+
+Run `node "${CLAUDE_PLUGIN_ROOT}/dist/cli.js" $ARGUMENTS` and report the resulting state in one line.
+
+With no action, run it with `status`.
+
+Pair mode intercepts your Write, Edit, and MultiEdit calls. The user reads the proposed diff in the
+pair review pane, selects lines, and attaches notes. Pair mode then holds the edit and
+returns those notes as questions anchored to line numbers. Answer every question. Do not
+re-attempt the edit until the user asks for it. An edit the user closes with no notes
+applies as proposed.
+
+Pair mode keys the flag by the real directory path, and the hook walks up from the edited
+file. A flag on a parent directory therefore covers every repo beneath it. If pair mode
+stays on after an `off`, check each parent with `status <dir>`.

package/hooks/codex.json

@@ -0,0 +1,17 @@
+{
+  "description": "Pair mode holds a proposed edit so the user can annotate the diff line by line.",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "apply_patch|Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${PLUGIN_ROOT}/dist/codex.js\"",
+            "timeout": 600
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/claude-code.js\"",
+            "timeout": 600
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pair-mode",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Annotate a coding agent's proposed edits line by line, in your terminal.",
   "keywords": [
     "ai",
@@ -31,6 +31,11 @@
   "files": [
     "dist",
     "assets",
+    ".claude-plugin/plugin.json",
+    ".codex-plugin/plugin.json",
+    "hooks",
+    "commands",
+    "skills",
     "README.md"
   ],
   "type": "module",

package/skills/pair/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: pair
+description: Toggle pair mode. Every proposed edit opens in the pair review pane for line annotation.
+---
+
+Read the action from the user's message, then run `pair-mode <action>` and report the resulting state in one line.
+
+With no action, run `pair-mode status`.
+
+Pair mode intercepts your apply_patch, Write, and Edit calls. The user reads the proposed diff in the
+pair review pane, selects lines, and attaches notes. Pair mode then holds the edit and
+returns those notes as questions anchored to line numbers. Answer every question. Do not
+re-attempt the edit until the user asks for it. An edit the user closes with no notes
+applies as proposed.
+
+Pair mode keys the flag by the real directory path, and the hook walks up from the edited
+file. A flag on a parent directory therefore covers every repo beneath it. If pair mode
+stays on after an `off`, check each parent with `pair-mode status <dir>`.
+
+The `pair-mode` command must resolve on PATH. Install it with `npm install -g pair-mode`.