open-plan-annotator 0.1.2 → 0.1.4

package/.claude-plugin/marketplace.json

@@ -0,0 +1,30 @@
+{
+  "name": "open-plan-annotator",
+  "owner": {
+    "name": "ndom91"
+  },
+  "metadata": {
+    "description": "Interactive plan annotation plugin for Claude Code",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "open-plan-annotator",
+      "source": "./",
+      "description": "Interactive plan annotation UI: review, strikethrough, and comment on Claude's plans before approving. Fully local, no external services.",
+      "version": "0.1.4",
+      "author": {
+        "name": "ndom91"
+      },
+      "homepage": "https://github.com/ndom91/open-plan-annotator",
+      "license": "MIT",
+      "keywords": [
+        "planning",
+        "review",
+        "hooks",
+        "ExitPlanMode",
+        "annotations"
+      ]
+    }
+  ]
+}

package/{plugin → .claude-plugin}/plugin.json

@@ -1,10 +1,13 @@
 {
   "name": "open-plan-annotator",
   "description": "Interactive plan annotation UI: review, strikethrough, and comment on Claude's plans before approving. Fully local, no external services.",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "author": {
-    "name": "ndomino"
+    "name": "ndom91"
   },
+  "homepage": "https://github.com/ndom91/open-plan-annotator",
+  "repository": "https://github.com/ndom91/open-plan-annotator",
+  "license": "MIT",
   "keywords": [
     "planning",
     "review",

package/README.md

@@ -20,15 +20,38 @@ The server shuts down after you decide. Everything runs locally, nothing leaves
 
 ## Install
 
+**1. Install the binary**
+
+```sh
+npm install -g open-plan-annotator
+```
+
+This downloads the correct binary for your platform (macOS, Linux).
+
+**2. Add the marketplace and install the plugin**
+
+From within Claude Code:
+
+```
+/plugin marketplace add ndom91/open-plan-annotator
+/plugin install open-plan-annotator@ndom91-open-plan-annotator
+```
+
+This registers the `ExitPlanMode` hook that launches the annotation UI.
+
+### From source
+
 ```sh
+git clone https://github.com/ndom91/open-plan-annotator.git
+cd open-plan-annotator
 bun install
 bun run build
 ```
 
-This produces a single compiled binary at `build/open-plan-annotator`. Add it to your `PATH`, then install the plugin in Claude Code:
+Then load it directly in Claude Code:
 
 ```sh
-claude plugin add /path/to/open-plan-annotator/plugin
+claude --plugin-dir ./open-plan-annotator
 ```
 
 ## Annotations

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-plan-annotator",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "description": "Fully local plugin for interactive plan annotation from your Agentic assistants",
   "author": "ndom91",
@@ -17,12 +17,14 @@
     "code-review"
   ],
   "bin": {
-    "open-plan-annotator": "bin/open-plan-annotator"
+    "open-plan-annotator": "bin/open-plan-annotator.cjs"
   },
   "files": [
-    "bin/open-plan-annotator",
+    "bin/open-plan-annotator.cjs",
     "install.cjs",
-    "plugin/",
+    ".claude-plugin/",
+    "hooks/",
+    "CLAUDE.md",
     "README.md"
   ],
   "scripts": {
@@ -38,7 +40,7 @@
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
-    "publish": "./scripts/release.sh"
+    "do-release": "./scripts/release.sh"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.4"

package/plugin/CLAUDE.md

@@ -1,28 +0,0 @@
-# open-plan-annotator: Plan Review Instructions
-
-## ALWAYS Use Plan Mode for Non-Trivial Tasks
-
-Before beginning any implementation that involves:
-- Creating or modifying more than 2 files
-- Architectural or structural changes
-- Anything the user hasn't explicitly described step-by-step
-- Refactoring, migration, or feature additions
-- Bug fixes that require investigation
-
-You MUST use plan mode to present your approach first.
-
-## Why This Matters
-
-The user has installed the open-plan-annotator plugin specifically to review and annotate your plans before you write code. Skipping plan mode bypasses this workflow entirely and removes the user's ability to give structured feedback.
-
-## Plan Quality Standards
-
-When writing a plan, include:
-- A brief summary of what you understood the task to require
-- The specific files you intend to create or modify and why
-- Any assumptions you are making
-- An explicit question if anything is ambiguous
-
-## When Plan Mode Is Optional
-
-For truly trivial tasks (fix a typo, rename a single variable, answer a factual question), plan mode is not required. When in doubt, use it anyway — the user can always approve immediately.