@alexismunozdev/claude-session-topics 2.1.0 → 2.2.0

package/README.md

@@ -20,7 +20,8 @@ Supported colors: `red`, `green`, `yellow`, `blue`, `magenta` (default), `cyan`,
 
 ## What it does
 
-- Auto-detects a session topic from context on the first prompt
+- A Stop hook sets the initial topic automatically after Claude's first response (no model tokens spent)
+- The auto-topic skill refines the topic when the conversation shifts
 - Shows the topic in the Claude Code statusline (`◆ Topic`)
 - Change the topic anytime with `/set-topic`
 - Composes with existing statusline plugins (doesn't overwrite)
@@ -28,10 +29,11 @@ Supported colors: `red`, `green`, `yellow`, `blue`, `magenta` (default), `cyan`,
 ## What the installer configures
 
 1. Copies the statusline script to `~/.claude/session-topics/`
-2. Configures `statusLine` in `~/.claude/settings.json`
-3. Adds bash permission for the script
-4. Installs `auto-topic` and `set-topic` skills to `~/.claude/skills/`
-5. If you already have a statusline, creates a wrapper that shows both
+2. Installs the Stop hook (`auto-topic-hook.sh`) that sets the initial topic
+3. Configures `statusLine` in `~/.claude/settings.json`
+4. Adds bash permission for the script
+5. Installs `auto-topic` and `set-topic` skills to `~/.claude/skills/`
+6. If you already have a statusline, creates a wrapper that shows both
 
 ## Requirements
 
@@ -60,7 +62,7 @@ The default topic color is bold magenta. Three ways to change it:
 
 ### Auto-topic (automatic)
 
-Starts automatically on session start. Claude reads your first message and sets a short topic (2-4 words) summarizing the task.
+After Claude's first response, a Stop hook extracts a 2-4 word topic from your first message using lightweight heuristics (no model tokens spent). The auto-topic skill then monitors the conversation and updates the topic when you shift to a different subject.
 
 ### /set-topic (manual)
 
@@ -76,16 +78,18 @@ Change the topic at any time:
 ```
 Session starts
     |
-auto-topic skill fires on first message
+Claude sends first response
     |
-Claude writes topic to ~/.claude/session-topics/${SESSION_ID}
+Stop hook (auto-topic-hook.sh) extracts topic from first user message
     |
-Statusline script reads the topic file
+Writes topic to ~/.claude/session-topics/${SESSION_ID}
     |
-Displays: ◆ Topic
+auto-topic skill monitors for conversation shifts and updates topic
+    |
+Statusline script reads the topic file → displays: ◆ Topic
 ```
 
-The statusline script receives the session ID via stdin JSON, reads the corresponding topic file, and renders it with ANSI color codes.
+The Stop hook runs after each model response and uses heuristics to extract the initial topic from the transcript. On subsequent messages, the auto-topic skill handles topic updates when the conversation shifts. The statusline script receives the session ID via stdin JSON, reads the corresponding topic file, and renders it with ANSI color codes.
 
 ## Uninstall
 

package/hooks/hooks.json

@@ -0,0 +1,39 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "COLOR='${user_config.topic_color}'; [ -n \"$COLOR\" ] && mkdir -p \"$HOME/.claude/session-topics\" && echo \"$COLOR\" > \"$HOME/.claude/session-topics/.color-config\" || true"
+          },
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/auto-setup.sh\" || true"
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/auto-allow.sh\" || true"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/scripts/auto-topic-hook.sh\" || true"
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@alexismunozdev/claude-session-topics",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Session topics for Claude Code — auto-set and display a topic in the statusline, change anytime with /set-topic",
   "bin": {
     "claude-session-topics": "bin/install.js"
   },
   "files": [
     "bin/",
+    "hooks/",
     "scripts/",
     "skills/",
     "LICENSE",

package/scripts/auto-allow.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+# Auto-approve Bash commands containing "session-topics" (PermissionRequest hook)
+# Writes the allow rule to userSettings so future requests skip the prompt
+
+input=$(cat)
+CMD=$(echo "$input" | jq -r '.tool_input.command // ""')
+
+if echo "$CMD" | grep -q 'session-topics'; then
+    cat <<'EOF'
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PermissionRequest",
+    "permissionDecision": "allow",
+    "updatedPermissions": [
+      {
+        "type": "addRules",
+        "rules": [{"toolName": "Bash", "ruleContent": "*session-topics*"}],
+        "behavior": "allow",
+        "destination": "userSettings"
+      }
+    ]
+  }
+}
+EOF
+fi

package/scripts/auto-setup.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# Auto-configure statusline on first run (SessionStart hook)
+# Handles two cases:
+#   1. No statusline configured -> set plugin's statusline.sh directly
+#   2. Existing custom statusline -> generate a wrapper that prepends topic to original output
+
+SETTINGS="$HOME/.claude/settings.json"
+TOPIC_DIR="$HOME/.claude/session-topics"
+WRAPPER="$TOPIC_DIR/wrapper-statusline.sh"
+STABLE_SL="$TOPIC_DIR/plugin-statusline.sh"
+ORIG_CMD_FILE="$TOPIC_DIR/.original-statusline-cmd"
+
+[ ! -f "$SETTINGS" ] && exit 0
+
+# Find the plugin's statusline script via CLAUDE_PLUGIN_ROOT (set by hooks system)
+PLUGIN_SL="${CLAUDE_PLUGIN_ROOT}/scripts/statusline.sh"
+[ ! -f "$PLUGIN_SL" ] && exit 0
+
+mkdir -p "$TOPIC_DIR"
+
+# Always refresh the stable copy (keeps it up-to-date across plugin updates)
+cp "$PLUGIN_SL" "$STABLE_SL"
+chmod +x "$STABLE_SL"
+
+CURRENT_CMD=$(jq -r '.statusLine.command // ""' "$SETTINGS" 2>/dev/null)
+
+# Already integrated — skip (but the copy above still refreshes)
+echo "$CURRENT_CMD" | grep -q 'session-topics' && exit 0
+
+HAS_STATUSLINE=$(jq 'has("statusLine")' "$SETTINGS" 2>/dev/null)
+
+if [ "$HAS_STATUSLINE" = "true" ] && [ -n "$CURRENT_CMD" ]; then
+    # Case 2: User has a custom statusline — generate wrapper
+    echo "$CURRENT_CMD" > "$ORIG_CMD_FILE"
+
+    cat > "$WRAPPER" << 'WRAPPER_EOF'
+#!/bin/bash
+input=$(cat)
+
+# Run the plugin's topic statusline (stable copy refreshed each session)
+TOPIC_OUTPUT=""
+if [ -f "$HOME/.claude/session-topics/plugin-statusline.sh" ]; then
+    TOPIC_OUTPUT=$(echo "$input" | bash "$HOME/.claude/session-topics/plugin-statusline.sh" 2>/dev/null || echo "")
+fi
+
+# Run the user's original statusline command
+ORIG_CMD=$(cat "$HOME/.claude/session-topics/.original-statusline-cmd" 2>/dev/null || echo "")
+ORIG_OUTPUT=""
+if [ -n "$ORIG_CMD" ]; then
+    ORIG_OUTPUT=$(echo "$input" | bash -c "$ORIG_CMD" 2>/dev/null || echo "")
+fi
+
+# Combine: topic | original
+if [ -n "$TOPIC_OUTPUT" ] && [ -n "$ORIG_OUTPUT" ]; then
+    echo -e "${TOPIC_OUTPUT} | ${ORIG_OUTPUT}"
+elif [ -n "$TOPIC_OUTPUT" ]; then
+    echo -e "${TOPIC_OUTPUT}"
+elif [ -n "$ORIG_OUTPUT" ]; then
+    echo -e "${ORIG_OUTPUT}"
+fi
+WRAPPER_EOF
+    chmod +x "$WRAPPER"
+
+    jq --arg cmd "bash \"$WRAPPER\"" '.statusLine.command = $cmd' "$SETTINGS" > "${SETTINGS}.tmp" && mv "${SETTINGS}.tmp" "$SETTINGS"
+else
+    # Case 1: No statusline at all — use stable copy directly
+    jq --arg cmd "bash \"$STABLE_SL\"" '.statusLine = {"type": "command", "command": $cmd}' "$SETTINGS" > "${SETTINGS}.tmp" && mv "${SETTINGS}.tmp" "$SETTINGS"
+fi

package/skills/set-topic/SKILL.md

@@ -28,7 +28,7 @@ if [ -z "$SESSION_ID" ]; then
     echo "Error: No active session found. The statusline must run at least once before setting a topic."
     exit 1
 fi
-TOPIC=$(printf '%s' "$ARGUMENTS" | tr -cd 'a-zA-Z0-9 .,:!?'"'"'-' | cut -c1-100)
+TOPIC=$(printf '%s' "$ARGUMENTS" | sed "s/[^a-zA-Z0-9àáâãäåèéêëìíîïòóôõöùúûüýÿñçÀÁÂÃÄÅÈÉÊËÌÍÎÏÒÓÔÕÖÙÚÛÜÝÑÇ .,:!?'-]//g" | cut -c1-100)
 if [ -z "$TOPIC" ]; then
     echo "Error: Topic text is empty after sanitization."
     exit 1