@openthread/claude-code-plugin 0.1.1 → 0.1.3

package/.claude-plugin/plugin.json

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

package/README.md

@@ -1,9 +1,9 @@
 # @openthread/claude-code-plugin
 
-Share Claude Code conversations to [OpenThread](https://openthread.dev) -- a Reddit-like platform for AI conversation threads.
+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.dev) -- a Red
 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.dev/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.dev/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
 
@@ -72,16 +111,17 @@ Environment variables override the default endpoints. Set them in your shell pro
 
 | Variable | Default | Description |
 | --- | --- | --- |
-| `OPENTHREAD_API_URL` | `https://api.openthread.dev` | Backend API base URL |
-| `OPENTHREAD_WEB_URL` | `https://openthread.dev` | Web app base URL (used for post links) |
+| `OPENTHREAD_API_URL` | `https://openthread.me/api` | Backend API base URL |
+| `OPENTHREAD_WEB_URL` | `https://openthread.me` | Web app base URL (used for post links) |
 
 ## Manual Install
 
 If you prefer not to use npm:
 
-1. Download the latest `.zip` release from [openthread.dev/extensions](https://openthread.dev/extensions).
+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

@@ -5,17 +5,78 @@ set -euo pipefail
 PLUGIN_NAME="openthread-share"
 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() {
+  # Register the plugin in ~/.claude/settings.json so Claude Code loads it
+  python3 -c "
+import json, os
+
+settings_path = '$SETTINGS_FILE'
+dest_dir = '$DEST_DIR'
+
+settings = {}
+if os.path.exists(settings_path):
+    try:
+        with open(settings_path) as f:
+            settings = json.load(f)
+    except:
+        settings = {}
+
+if not isinstance(settings.get('enabledPlugins'), list):
+    settings['enabledPlugins'] = []
+
+# Check if already registered
+already = any(
+    p.get('source', {}).get('path') == dest_dir
+    for p in settings['enabledPlugins']
+)
+
+if not already:
+    settings['enabledPlugins'].append({
+        'source': {'type': 'local', 'path': dest_dir}
+    })
+    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() {
+  # Remove the plugin from ~/.claude/settings.json
+  if [ -f "$SETTINGS_FILE" ]; then
+    python3 -c "
+import json
+
+settings_path = '$SETTINGS_FILE'
+dest_dir = '$DEST_DIR'
+
+with open(settings_path) as f:
+    settings = json.load(f)
+
+if isinstance(settings.get('enabledPlugins'), list):
+    settings['enabledPlugins'] = [
+        p for p in settings['enabledPlugins']
+        if p.get('source', {}).get('path') != dest_dir
+    ]
+    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 +92,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 "  Use /ot:share in Claude Code 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 any(p.get('source',{}).get('path') == '$DEST_DIR' for p in plugins) 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 (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,42 @@ try {
     }
   }
 
+  // Register plugin in ~/.claude/settings.json so Claude Code detects it
+  const settingsPath = join(homedir(), ".claude", "settings.json");
+  const pluginEntry = {
+    source: {
+      type: "local",
+      path: pluginDest,
+    },
+  };
+
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+    } catch {
+      settings = {};
+    }
+  }
+
+  if (!Array.isArray(settings.enabledPlugins)) {
+    settings.enabledPlugins = [];
+  }
+
+  // Only add if not already registered
+  const alreadyRegistered = settings.enabledPlugins.some(
+    (p) => p.source && p.source.path === pluginDest
+  );
+  if (!alreadyRegistered) {
+    settings.enabledPlugins.push(pluginEntry);
+    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.1",
+  "version": "0.1.3",
   "description": "Share Claude Code conversations to OpenThread",
   "bin": {
     "openthread-claude": "bin/cli.sh"

package/scripts/auth.sh

@@ -7,8 +7,8 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck source=token.sh
 source "$SCRIPT_DIR/token.sh"
 
-API_BASE="${OPENTHREAD_API_URL:-https://api.openthread.dev}"
-WEB_BASE="${OPENTHREAD_WEB_URL:-https://openthread.dev}"
+API_BASE="${OPENTHREAD_API_URL:-https://openthread.me/api}"
+WEB_BASE="${OPENTHREAD_WEB_URL:-https://openthread.me}"
 EXTENSION_ID="claude-code"
 CALLBACK_PORT=18923
 REDIRECT_URI="http://localhost:${CALLBACK_PORT}/callback"
@@ -149,7 +149,7 @@ exchange_code() {
 
   echo "Exchanging authorization code for tokens..." >&2
 
-  RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/api/auth/extension/token" \
+  RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/auth/extension/token" \
     -H "Content-Type: application/json" \
     -d "{
       \"code\": \"${auth_code}\",

package/scripts/share.sh

@@ -1,13 +1,13 @@
 #!/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)"
-API_BASE="${OPENTHREAD_API_URL:-https://api.openthread.dev}"
+API_BASE="${OPENTHREAD_API_URL:-https://openthread.me/api}"
 
 # --- Parse JSONL session file into compact markdown body ---
 # Extracts only text blocks from assistant messages, skips thinking/tool_use/tool_result/etc.
@@ -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,10 +132,10 @@ 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}/api/posts/import" \
+  RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/posts/import" \
     -H "Authorization: Bearer ${access_token}" \
     -H "Content-Type: application/json" \
     -d "$payload")
@@ -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,10 +197,10 @@ 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}/api/posts/import" \
+  RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/posts/import" \
     -H "Authorization: Bearer ${access_token}" \
     -H "Content-Type: application/json" \
     -d "$payload")
@@ -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

package/scripts/token.sh

@@ -7,7 +7,7 @@
 #   bash token.sh check       — exit 0 if authenticated, 1 if not
 set -euo pipefail
 
-API_BASE="${OPENTHREAD_API_URL:-https://api.openthread.dev}"
+API_BASE="${OPENTHREAD_API_URL:-https://openthread.me/api}"
 EXTENSION_ID="claude-code"
 CREDENTIALS_DIR="$HOME/.config/openthread"
 CREDENTIALS_FILE="$CREDENTIALS_DIR/credentials.json"
@@ -75,7 +75,7 @@ refresh_token() {
   local current_refresh
   current_refresh=$(get_refresh_token) || return 1
 
-  RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/api/auth/extension/refresh" \
+  RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "${API_BASE}/auth/extension/refresh" \
     -H "Content-Type: application/json" \
     -d "{
       \"refreshToken\": \"${current_refresh}\",

package/skills/share-thread/SKILL.md

@@ -10,8 +10,8 @@ This skill shares the current Claude Code conversation to OpenThread in 4 steps.
 ## Configuration
 
 ```
-API_BASE="${OPENTHREAD_API_URL:-http://localhost:3001}"
-WEB_BASE="${OPENTHREAD_WEB_URL:-http://localhost:3000}"
+API_BASE="${OPENTHREAD_API_URL:-https://openthread.me/api}"
+WEB_BASE="${OPENTHREAD_WEB_URL:-https://openthread.me}"
 PLUGIN_DIR=<directory containing this skill — find it relative to this file, e.g. apps/claude-code-plugin or ~/.claude/plugins/openthread-share>
 ```
 
@@ -93,7 +93,7 @@ First, check if the `/share-thread` command was invoked with **arguments** (any
 
 1. **Fetch communities**:
    ```bash
-   curl -s -H "Authorization: Bearer $ACCESS_TOKEN" "$API_BASE/api/communities?limit=50"
+   curl -s -H "Authorization: Bearer $ACCESS_TOKEN" "$API_BASE/communities?limit=50"
    ```
    Response format: `{"data": [{"id": "uuid", "name": "Name", "slug": "slug"}, ...], "pagination": {...}}`