@openthread/claude-code-plugin 0.1.2 → 0.1.4

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
-  "name": "openthread-share",
-  "version": "0.1.2",
+  "name": "ot",
+  "version": "0.1.4",
   "description": "Share Claude Code conversations to OpenThread",
   "icon": "icon.svg",
   "author": {

package/README.md

@@ -3,7 +3,7 @@
 Share Claude Code conversations to [OpenThread](https://openthread.me) -- a Reddit-like platform for AI conversation threads.
 
 [![npm version](https://img.shields.io/npm/v/@openthread/claude-code-plugin)](https://www.npmjs.com/package/@openthread/claude-code-plugin)
-[![license](https://img.shields.io/npm/l/@openthread/claude-code-plugin)](https://github.com/nicholasgriffintn/openthread/blob/main/LICENSE)
+[![license](https://img.shields.io/npm/l/@openthread/claude-code-plugin)](https://opensource.org/licenses/MIT)
 [![downloads](https://img.shields.io/npm/dm/@openthread/claude-code-plugin)](https://www.npmjs.com/package/@openthread/claude-code-plugin)
 
 ## Install
@@ -12,27 +12,66 @@ Share Claude Code conversations to [OpenThread](https://openthread.me) -- a Redd
 npm i -g @openthread/claude-code-plugin
 ```
 
-The postinstall script registers the plugin with Claude Code automatically.
+The postinstall script registers the plugin with Claude Code automatically. Restart Claude Code after installing.
 
 ## Quick Start
 
 ```
-You> /share fixing auth bug
+> /ot:share fixing auth bug
 
 Sharing conversation to OpenThread...
-Authenticated as @yourname
 Auto-generated title: "Debugging PKCE token refresh in auth middleware"
-Posted to c/ClaudeCode
+Community: Coding with AI
+Tags: typescript, authentication, debugging
 
-https://openthread.me/c/ClaudeCode/posts/abc123
+Post shared successfully!
+View it at: https://openthread.me/post/abc123
 ```
 
+## Examples
+
+### Share instantly with quick mode
+
+```
+> /ot:share building a REST API with Hono
+```
+
+Auto-generates title, picks the best community, adds tags, and posts -- no questions asked.
+
+### Share interactively
+
+```
+> /ot:share
+
+? Title: Building a REST API with Hono on Bun
+? Community:
+  > Coding with AI
+    Prompt Engineering
+    OpenThread Meta
+? Tags: typescript, hono, api
+
+Post shared successfully!
+View it at: https://openthread.me/post/def456
+```
+
+### Share after a long debugging session
+
+```
+> /ot:share tracked down a memory leak in the worker pool
+```
+
+The plugin reads the full conversation, generates a summary, and shares it as a post others can learn from.
+
+### Share from any project
+
+The plugin auto-detects the current Claude Code session file. Works in any project directory -- just run `/ot:share` and it finds the right conversation.
+
 ## Features
 
-- **One-command sharing** -- run `/share` inside any Claude Code session to publish the conversation to OpenThread.
-- **Quick mode** -- `/share <description>` auto-generates a title, selects a community, and posts immediately.
-- **Interactive mode** -- `/share` with no arguments prompts you to choose a title, community, and tags.
-- **Secure auth** -- PKCE OAuth flow with automatic token refresh. Credentials are stored locally.
+- **One-command sharing** -- run `/ot:share` inside any Claude Code session to publish the conversation to OpenThread.
+- **Quick mode** -- `/ot:share <description>` auto-generates a title, selects a community, and posts immediately.
+- **Interactive mode** -- `/ot:share` with no arguments prompts you to choose a title, community, and tags.
+- **Secure auth** -- PKCE OAuth flow with automatic token refresh. Credentials are stored locally at `~/.config/openthread/`.
 - **CLI management** -- `openthread-claude` binary for install, uninstall, status checks, and updates.
 
 ## Usage
@@ -40,31 +79,31 @@ https://openthread.me/c/ClaudeCode/posts/abc123
 ### Quick mode
 
 ```
-/share fixing auth bug
+/ot:share <short description of what you worked on>
 ```
 
-Provide a short description after `/share`. The plugin generates a title from the conversation context, picks the best-matching community, and posts without further prompts.
+Provide a short description after `/ot:share`. The plugin generates a title from the conversation context, picks the best-matching community, and posts without further prompts.
 
 ### Interactive mode
 
 ```
-/share
+/ot:share
 ```
 
 Run with no arguments to step through each field:
 
 1. Title (suggested from conversation, editable)
-2. Community (searchable list)
-3. Tags (optional, comma-separated)
+2. Community (selectable from list)
+3. Tags (suggested, accept or modify)
 
 ## CLI Commands
 
 | Command | Description |
 | --- | --- |
-| `openthread-claude install` | Register the plugin with Claude Code |
-| `openthread-claude uninstall` | Remove the plugin from Claude Code |
-| `openthread-claude status` | Show current auth and plugin state |
-| `openthread-claude update` | Pull the latest plugin version |
+| `openthread-claude install` | Install and register the plugin with Claude Code |
+| `openthread-claude uninstall` | Remove the plugin and deregister from Claude Code |
+| `openthread-claude status` | Show plugin installation and registration state |
+| `openthread-claude update` | Reinstall plugin (update to current version) |
 
 ## Configuration
 
@@ -81,7 +120,8 @@ If you prefer not to use npm:
 
 1. Download the latest `.zip` release from [openthread.me/extensions](https://openthread.me/extensions).
 2. Extract it to `~/.claude/plugins/openthread-share/`.
-3. Restart Claude Code. The plugin will be detected on next launch.
+3. Run `openthread-claude install` to register with Claude Code.
+4. Restart Claude Code.
 
 ```bash
 mkdir -p ~/.claude/plugins/openthread-share

package/bin/cli.sh

@@ -3,19 +3,86 @@
 set -euo pipefail
 
 PLUGIN_NAME="openthread-share"
+PLUGIN_ID="ot"
+MARKETPLACE_NAME="local-plugins"
+PLUGIN_KEY="${PLUGIN_ID}@${MARKETPLACE_NAME}"
 PLUGIN_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 DEST_DIR="$HOME/.claude/plugins/$PLUGIN_NAME"
+SETTINGS_FILE="$HOME/.claude/settings.json"
 
 usage() {
   echo "Usage: openthread-claude <command>"
   echo ""
   echo "Commands:"
-  echo "  install     Install plugin to ~/.claude/plugins/"
-  echo "  uninstall   Remove plugin from ~/.claude/plugins/"
-  echo "  status      Check if plugin is installed"
+  echo "  install     Install and register plugin with Claude Code"
+  echo "  uninstall   Remove plugin and deregister from Claude Code"
+  echo "  status      Check if plugin is installed and registered"
   echo "  update      Reinstall plugin (update to current version)"
 }
 
+register_plugin() {
+  python3 -c "
+import json, os
+
+settings_path = '$SETTINGS_FILE'
+dest_dir = '$DEST_DIR'
+marketplace = '$MARKETPLACE_NAME'
+plugin_key = '$PLUGIN_KEY'
+
+settings = {}
+if os.path.exists(settings_path):
+    try:
+        with open(settings_path) as f:
+            settings = json.load(f)
+    except:
+        settings = {}
+
+# Register as local marketplace
+if 'extraKnownMarketplaces' not in settings:
+    settings['extraKnownMarketplaces'] = {}
+settings['extraKnownMarketplaces'][marketplace] = {
+    'source': {'source': 'directory', 'path': dest_dir}
+}
+
+# Enable the plugin (must be an object, not array)
+if not isinstance(settings.get('enabledPlugins'), dict):
+    settings['enabledPlugins'] = {}
+settings['enabledPlugins'][plugin_key] = True
+
+os.makedirs(os.path.dirname(settings_path), exist_ok=True)
+with open(settings_path, 'w') as f:
+    json.dump(settings, f, indent=2)
+    f.write('\n')
+"
+}
+
+deregister_plugin() {
+  if [ -f "$SETTINGS_FILE" ]; then
+    python3 -c "
+import json
+
+settings_path = '$SETTINGS_FILE'
+marketplace = '$MARKETPLACE_NAME'
+plugin_key = '$PLUGIN_KEY'
+
+with open(settings_path) as f:
+    settings = json.load(f)
+
+# Remove from enabledPlugins
+if isinstance(settings.get('enabledPlugins'), dict):
+    settings['enabledPlugins'].pop(plugin_key, None)
+
+# Remove marketplace
+if isinstance(settings.get('extraKnownMarketplaces'), dict):
+    settings['extraKnownMarketplaces'].pop(marketplace, None)
+
+with open(settings_path, 'w') as f:
+    json.dump(settings, f, indent=2)
+    f.write('\n')
+"
+  fi
+}
+
 install_plugin() {
   mkdir -p "$DEST_DIR"
 
@@ -31,26 +98,53 @@ install_plugin() {
 
   chmod +x "$DEST_DIR/scripts/"*.sh 2>/dev/null || true
 
+  register_plugin
+
   VERSION=$(python3 -c "import json; print(json.load(open('$DEST_DIR/.claude-plugin/plugin.json'))['version'])")
   echo "✓ OpenThread plugin v$VERSION installed to $DEST_DIR"
-  echo "  Use /share in Claude Code to share conversations."
+  echo "  Registered in $SETTINGS_FILE"
+  echo "  Restart Claude Code, then use /ot:share to share conversations."
 }
 
 uninstall_plugin() {
   if [ -d "$DEST_DIR" ]; then
     rm -rf "$DEST_DIR"
-    echo "✓ OpenThread plugin removed from $DEST_DIR"
+    deregister_plugin
+    echo "✓ OpenThread plugin removed and deregistered"
   else
     echo "Plugin is not installed."
   fi
 }
 
 check_status() {
+  local installed=false
+  local registered=false
+
   if [ -d "$DEST_DIR" ] && [ -f "$DEST_DIR/.claude-plugin/plugin.json" ]; then
+    installed=true
+  fi
+
+  if [ -f "$SETTINGS_FILE" ]; then
+    registered=$(python3 -c "
+import json
+with open('$SETTINGS_FILE') as f:
+    s = json.load(f)
+plugins = s.get('enabledPlugins', {})
+print('true' if isinstance(plugins, dict) and plugins.get('$PLUGIN_KEY') else 'false')
+" 2>/dev/null || echo "false")
+  fi
+
+  if [ "$installed" = true ]; then
     VERSION=$(python3 -c "import json; print(json.load(open('$DEST_DIR/.claude-plugin/plugin.json'))['version'])")
-    echo "✓ OpenThread plugin v$VERSION is installed at $DEST_DIR"
+    echo "✓ Plugin files: v$VERSION at $DEST_DIR"
+  else
+    echo "✗ Plugin files: not installed"
+  fi
+
+  if [ "$registered" = "true" ]; then
+    echo "✓ Registered: yes ($PLUGIN_KEY in $SETTINGS_FILE)"
   else
-    echo "✗ OpenThread plugin is not installed."
+    echo "✗ Registered: no (Claude Code won't detect the plugin)"
     echo "  Run: openthread-claude install"
   fi
 }

package/bin/postinstall.js

@@ -48,9 +48,44 @@ try {
     }
   }
 
+  // Register plugin in ~/.claude/settings.json so Claude Code detects it
+  const MARKETPLACE_NAME = "local-plugins";
+  const PLUGIN_ID = "ot";
+  const settingsPath = join(homedir(), ".claude", "settings.json");
+
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+    } catch {
+      settings = {};
+    }
+  }
+
+  // Register as a local marketplace
+  if (!settings.extraKnownMarketplaces) {
+    settings.extraKnownMarketplaces = {};
+  }
+  settings.extraKnownMarketplaces[MARKETPLACE_NAME] = {
+    source: {
+      source: "directory",
+      path: pluginDest,
+    },
+  };
+
+  // Enable the plugin
+  if (!settings.enabledPlugins || typeof settings.enabledPlugins !== "object" || Array.isArray(settings.enabledPlugins)) {
+    settings.enabledPlugins = {};
+  }
+  settings.enabledPlugins[`${PLUGIN_ID}@${MARKETPLACE_NAME}`] = true;
+
+  mkdirSync(join(homedir(), ".claude"), { recursive: true });
+  writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+
   const version = JSON.parse(readFileSync(join(pluginSrc, "package.json"), "utf8")).version;
   console.log(`\x1b[32m✓\x1b[0m OpenThread plugin v${version} installed to ${pluginDest}`);
-  console.log(`  Use \x1b[1m/share\x1b[0m in Claude Code to share conversations.`);
+  console.log(`  Registered in ${settingsPath}`);
+  console.log(`  Use \x1b[1m/ot:share\x1b[0m in Claude Code to share conversations.`);
 } catch (err) {
   console.error(`Warning: Could not auto-install plugin: ${err.message}`);
   console.error(`You can manually install by copying plugin files to ${pluginDest}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openthread/claude-code-plugin",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Share Claude Code conversations to OpenThread",
   "bin": {
     "openthread-claude": "bin/cli.sh"

package/scripts/share.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 # Share a Claude Code session to OpenThread
 # Usage:
-#   bash share.sh parse          <session_file>                                              — output compact markdown from JSONL
-#   bash share.sh import         <session_file> <title> <community_id> <tags> <token>        — parse JSONL & import as compact post
-#   bash share.sh import-export  <export_file>  <title> <community_id> <tags> <token>        — send /export text as body & import
+#   bash share.sh parse          <session_file>                                                       — output compact markdown from JSONL
+#   bash share.sh import         <session_file> <title> <community_id> <tags> <token> [summary]       — parse JSONL & import as compact post
+#   bash share.sh import-export  <export_file>  <title> <community_id> <tags> <token> [summary]       — send /export text as body & import
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -94,6 +94,7 @@ import_post() {
   local community_id="$3"
   local tags_csv="$4"
   local access_token="$5"
+  local summary="${6:-}"
 
   # Parse the session into compact markdown
   local compact_body
@@ -114,11 +115,14 @@ print(json.dumps(tags))
 " "$tags_csv")
   fi
 
-  # Build the import payload with body (no rawThread)
+  # Build the import payload — prepend summary to body if provided
   local payload
   payload=$(python3 -c "
 import json, sys
 body_text = sys.argv[1]
+summary = sys.argv[5] if len(sys.argv) > 5 and sys.argv[5] else ''
+if summary:
+    body_text = '> ' + summary.replace('\n', '\n> ') + '\n\n---\n\n' + body_text
 payload = {
     'title': sys.argv[2],
     'communityId': sys.argv[3],
@@ -128,7 +132,7 @@ payload = {
     'provider': 'claude',
 }
 print(json.dumps(payload))
-" "$compact_body" "$title" "$community_id" "$tags_json")
+" "$compact_body" "$title" "$community_id" "$tags_json" "$summary")
 
   # POST to import endpoint
   RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/posts/import" \
@@ -156,6 +160,7 @@ import_export_post() {
   local community_id="$3"
   local tags_csv="$4"
   local access_token="$5"
+  local summary="${6:-}"
 
   if [ ! -f "$export_file" ]; then
     echo "ERROR: Export file not found: $export_file" >&2
@@ -180,6 +185,9 @@ with open(sys.argv[1], 'r') as f:
     export_text = f.read()
 # Truncate to 500000 chars
 export_text = export_text[:500000]
+summary = sys.argv[5] if len(sys.argv) > 5 and sys.argv[5] else ''
+if summary:
+    export_text = '> ' + summary.replace('\n', '\n> ') + '\n\n---\n\n' + export_text
 payload = {
     'title': sys.argv[2],
     'communityId': sys.argv[3],
@@ -189,7 +197,7 @@ payload = {
     'provider': 'claude',
 }
 print(json.dumps(payload))
-" "$export_file" "$title" "$community_id" "$tags_json")
+" "$export_file" "$title" "$community_id" "$tags_json" "$summary")
 
   # POST to import endpoint
   RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/posts/import" \
@@ -221,17 +229,17 @@ case "${1:-}" in
     ;;
   import)
     if [ -z "${6:-}" ]; then
-      echo "Usage: share.sh import <session_file> <title> <community_id> <tags> <token>" >&2
+      echo "Usage: share.sh import <session_file> <title> <community_id> <tags> <token> [summary]" >&2
       exit 1
     fi
-    import_post "$2" "$3" "$4" "${5:--}" "$6"
+    import_post "$2" "$3" "$4" "${5:--}" "$6" "${7:-}"
     ;;
   import-export)
     if [ -z "${6:-}" ]; then
-      echo "Usage: share.sh import-export <export_file> <title> <community_id> <tags> <token>" >&2
+      echo "Usage: share.sh import-export <export_file> <title> <community_id> <tags> <token> [summary]" >&2
       exit 1
     fi
-    import_export_post "$2" "$3" "$4" "${5:--}" "$6"
+    import_export_post "$2" "$3" "$4" "${5:--}" "$6" "${7:-}"
     ;;
   *)
     echo "Usage: share.sh {parse|import|import-export} ..." >&2