open-plan-annotator 0.1.13 → 0.2.1

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "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.13",
+      "version": "0.2.1",
       "author": {
         "name": "ndom91"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "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.13",
+  "version": "0.2.1",
   "author": {
     "name": "ndom91"
   },

package/CLAUDE.md

@@ -0,0 +1,28 @@
+# 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.

package/README.md

@@ -1,11 +1,16 @@
 # open-plan-annotator
 
+[![npm version](https://img.shields.io/npm/v/open-plan-annotator?style=flat-square)](https://www.npmjs.com/package/open-plan-annotator)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-pink?style=flat-square)]()
+
 A fully local agentic coding plugin (claude-code, opencode) that intercepts plan mode, opens an annotation UI in your browser, and feeds structured feedback back to the agent.
 
-Select text to strikethrough, replace, insert, or comment — then approve the plan or request changes.
+Select text to <code style="color: purple">strikethrough</code>, <code style="color: orange">replace</code>, <code style="color: blue">insert</code>, or <code style="color: red">comment</code> — then approve the plan or request changes.
+
+
+![](.github/assets/screenshot_01.png)
 
-![](.github/assets/screenshot_001.png)
-> UI for annotating LLM Plans
 
 ## How it works
 
@@ -26,7 +31,12 @@ The server shuts down after you decide. Everything runs locally, nothing leaves
 npm install -g open-plan-annotator
 ```
 
-This downloads the correct binary for your platform (macOS, Linux).
+This JS shim downloads the correct binary for your platform (macOS, Linux).
+
+> [!NOTE]
+> If using pnpm, postinstall scripts will be blocked by default. You can run the
+> 'open-plan-annotator' manually to trigger a download, or the first invocation
+> by Claude will also trigger the binary download.
 
 **2. Add the marketplace and install the plugin**
 
@@ -39,6 +49,11 @@ From within Claude Code:
 
 This registers the `ExitPlanMode` hook that launches the annotation UI.
 
+
+> [!NOTE]
+> The first run might take a few seconds if you hadn't installed the binary, as
+> Claude will trigger the download then.
+
 ### From source
 
 ```sh

package/bin/open-plan-annotator.cjs

@@ -20,7 +20,7 @@ if (!fs.existsSync(binaryPath)) {
   console.error("open-plan-annotator: binary not found, downloading...");
   try {
     execFileSync(process.execPath, [installScript], {
-      stdio: ["ignore", "inherit", "inherit"],
+      stdio: ["ignore", 2, "inherit"],
     });
   } catch (e) {
     console.error(

package/install.cjs

@@ -89,7 +89,7 @@ async function main() {
   }
 
   const url = getDownloadUrl();
-  console.log(`Downloading open-plan-annotator for ${getPlatformKey()}...`);
+  console.error(`Downloading open-plan-annotator for ${getPlatformKey()}...`);
 
   const buffer = await fetch(url);
   const binaryBuffer = extractBinaryFromTarGz(buffer);
@@ -99,7 +99,7 @@ async function main() {
   }
 
   fs.writeFileSync(destPath, binaryBuffer, { mode: 0o755 });
-  console.log(`Installed open-plan-annotator to ${destPath}`);
+  console.error(`Installed open-plan-annotator to ${destPath}`);
 }
 
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-plan-annotator",
-  "version": "0.1.13",
+  "version": "0.2.1",
   "type": "module",
   "description": "Fully local plugin for interactive plan annotation from your Agentic assistants",
   "author": "ndom91",
@@ -40,7 +40,9 @@
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
-    "do-release": "./scripts/release.sh"
+    "do-release": "./scripts/release.sh",
+    "prepack": "cp CLAUDE.plugin.md CLAUDE.md",
+    "postpack": "rm -f CLAUDE.md"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.4"