@alexismunozdev/claude-session-topics 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexis Muñoz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# claude-session-topics
+
+Session topics for Claude Code. Auto-detect and display a topic in the statusline, change anytime with `/set-topic`.
+
+![Session topics demo](https://github.com/user-attachments/assets/3698013f-123c-4d7e-8511-44718da5c3a4)
+
+## Install
+
+```bash
+npx @alexismunozdev/claude-session-topics
+```
+
+## With color
+
+```bash
+npx @alexismunozdev/claude-session-topics --color cyan
+```
+
+Supported colors: `red`, `green`, `yellow`, `blue`, `magenta` (default), `cyan`, `white`, `orange`, `grey`/`gray`. Raw ANSI codes are also accepted (e.g., `38;5;208`).
+
+## What it does
+
+- Auto-detects a session topic from context on the first prompt
+- Shows the topic in the Claude Code statusline (`◆ Topic`)
+- Change the topic anytime with `/set-topic`
+- Composes with existing statusline plugins (doesn't overwrite)
+
+## 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
+
+## Requirements
+
+- `jq`
+- `bash`
+- POSIX-compatible system (macOS, Linux)
+
+## Customization
+
+The default topic color is bold magenta. Three ways to change it:
+
+- Re-run with `--color <name>`:
+  ```bash
+  npx @alexismunozdev/claude-session-topics --color cyan
+  ```
+- Edit the config file directly:
+  ```bash
+  echo "cyan" > ~/.claude/session-topics/.color-config
+  ```
+- Set the `CLAUDE_TOPIC_COLOR` environment variable:
+  ```bash
+  export CLAUDE_TOPIC_COLOR="cyan"
+  ```
+
+## Usage
+
+### Auto-topic (automatic)
+
+Starts automatically on session start. Claude reads your first message and sets a short topic (2-4 words) summarizing the task.
+
+### /set-topic (manual)
+
+Change the topic at any time:
+
+```
+/set-topic Fix Login Bug
+/set-topic API Redesign
+```
+
+## How it works
+
+```
+Session starts
+    |
+auto-topic skill fires on first message
+    |
+Claude writes topic to ~/.claude/session-topics/${SESSION_ID}
+    |
+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.
+
+## Uninstall
+
+```bash
+npx @alexismunozdev/claude-session-topics --uninstall
+```
+
+## License
+
+MIT

package/bin/install.js

@@ -0,0 +1,431 @@
+#!/usr/bin/env node
+
+// claude-session-topics — npx installer
+// Installs statusline script, skills, and configures settings.json
+// Zero runtime dependency on npm after installation.
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// ─── ANSI helpers ────────────────────────────────────────────────────────────
+
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const CYAN = '\x1b[36m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RESET = '\x1b[0m';
+
+const ok = (msg) => console.log(`  ${GREEN}\u2713${RESET} ${msg}`);
+const warn = (msg) => console.log(`  ${YELLOW}\u26A0${RESET} ${msg}`);
+const err = (msg) => console.error(`  ${RED}\u2717${RESET} ${msg}`);
+const info = (msg) => console.log(`  ${DIM}${msg}${RESET}`);
+const heading = (msg) => console.log(`\n${BOLD}${CYAN}${msg}${RESET}\n`);
+
+// ─── Destination paths (fixed — never change) ───────────────────────────────
+
+const HOME = os.homedir();
+const TOPICS_DIR = path.join(HOME, '.claude', 'session-topics');
+const DEST_STATUSLINE = path.join(TOPICS_DIR, 'statusline.sh');
+const DEST_WRAPPER = path.join(TOPICS_DIR, 'wrapper-statusline.sh');
+const ORIG_CMD_FILE = path.join(TOPICS_DIR, '.original-statusline-cmd');
+const COLOR_CONFIG = path.join(TOPICS_DIR, '.color-config');
+const SKILLS_DIR = path.join(HOME, '.claude', 'skills');
+const SETTINGS_FILE = path.join(HOME, '.claude', 'settings.json');
+
+// ─── Source paths (relative to this script) ──────────────────────────────────
+
+const SRC_STATUSLINE = path.join(__dirname, '..', 'scripts', 'statusline.sh');
+const SRC_SKILLS = path.join(__dirname, '..', 'skills');
+
+// ─── The statusline command that settings.json will reference ────────────────
+
+const STATUSLINE_CMD = `bash "$HOME/.claude/session-topics/statusline.sh"`;
+const WRAPPER_CMD = `bash "$HOME/.claude/session-topics/wrapper-statusline.sh"`;
+
+// ─── Permission rule ─────────────────────────────────────────────────────────
+
+const PERMISSION_RULE = 'Bash(*session-topics*)';
+
+// ─── Wrapper script content ──────────────────────────────────────────────────
+
+const WRAPPER_SCRIPT = `#!/bin/bash
+input=$(cat)
+TOPIC_OUTPUT=$(echo "$input" | bash "$HOME/.claude/session-topics/statusline.sh" 2>/dev/null || echo "")
+ORIG_CMD=$(cat "$HOME/.claude/session-topics/.original-statusline-cmd" 2>/dev/null || echo "")
+ORIG_OUTPUT=""
+[ -n "$ORIG_CMD" ] && ORIG_OUTPUT=$(echo "$input" | eval "$ORIG_CMD" 2>/dev/null || echo "")
+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
+`;
+
+// ─── Utility functions ───────────────────────────────────────────────────────
+
+function readSettings() {
+    try {
+        const raw = fs.readFileSync(SETTINGS_FILE, 'utf8');
+        return JSON.parse(raw);
+    } catch {
+        return {};
+    }
+}
+
+function writeSettings(obj) {
+    const dir = path.dirname(SETTINGS_FILE);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(SETTINGS_FILE, JSON.stringify(obj, null, 2) + '\n', 'utf8');
+}
+
+function copyDirRecursive(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath);
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+
+function hasJq() {
+    try {
+        execSync('which jq', { stdio: 'pipe' });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+// ─── CLI argument parsing ────────────────────────────────────────────────────
+
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const result = { action: 'install', color: null };
+
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            result.action = 'help';
+            return result;
+        }
+        if (arg === '--uninstall') {
+            result.action = 'uninstall';
+            return result;
+        }
+        if (arg === '--color') {
+            if (i + 1 < args.length) {
+                result.color = args[i + 1];
+                i++;
+            } else {
+                err('--color requires a value (e.g., --color cyan)');
+                process.exit(1);
+            }
+        }
+    }
+
+    return result;
+}
+
+// ─── Help ────────────────────────────────────────────────────────────────────
+
+function showHelp() {
+    console.log(`
+${BOLD}claude-session-topics${RESET} — session topics for Claude Code
+
+${BOLD}Usage:${RESET}
+  npx @alexismunozdev/claude-session-topics            Install
+  npx @alexismunozdev/claude-session-topics --color cyan  Install with color
+  npx @alexismunozdev/claude-session-topics --uninstall   Uninstall
+
+${BOLD}Options:${RESET}
+  --color <name>   Set topic color (red, green, yellow, blue, magenta,
+                    cyan, white, orange, grey). Default: magenta
+  --uninstall      Remove scripts, settings, and skills (preserves topic data)
+  -h, --help       Show this help
+
+${BOLD}What it does:${RESET}
+  - Copies statusline.sh to ~/.claude/session-topics/
+  - Configures statusLine in ~/.claude/settings.json
+  - Adds Bash permission for session-topics commands
+  - Installs auto-topic and set-topic skills to ~/.claude/skills/
+
+${BOLD}After install:${RESET}
+  The statusline shows the current topic automatically.
+  Use ${CYAN}/set-topic <text>${RESET} to change it manually.
+`);
+}
+
+// ─── Install ─────────────────────────────────────────────────────────────────
+
+function install(color) {
+    heading('Installing claude-session-topics');
+
+    // ── Step 1: Check deps ───────────────────────────────────────────────
+
+    if (!hasJq()) {
+        err('jq is required but not found in PATH.');
+        console.log(`\n  Install it:  ${BOLD}brew install jq${RESET}  (macOS)`);
+        console.log(`               ${BOLD}sudo apt install jq${RESET}  (Ubuntu/Debian)\n`);
+        process.exit(1);
+    }
+    ok('jq found');
+
+    // ── Step 2: Create dir ───────────────────────────────────────────────
+
+    fs.mkdirSync(TOPICS_DIR, { recursive: true });
+    ok(`Created ${DIM}~/.claude/session-topics/${RESET}`);
+
+    // ── Step 3: Copy statusline ──────────────────────────────────────────
+
+    if (!fs.existsSync(SRC_STATUSLINE)) {
+        err(`Source statusline not found: ${SRC_STATUSLINE}`);
+        process.exit(1);
+    }
+    fs.copyFileSync(SRC_STATUSLINE, DEST_STATUSLINE);
+    fs.chmodSync(DEST_STATUSLINE, 0o755);
+    ok('Copied statusline.sh');
+
+    // ── Step 4: Configure statusline in settings.json ────────────────────
+
+    const settings = readSettings();
+    const statusLineCase = determineStatusLineCase(settings);
+
+    switch (statusLineCase) {
+        case 'A': {
+            // No statusLine — create fresh
+            settings.statusLine = {
+                type: 'command',
+                command: STATUSLINE_CMD,
+            };
+            writeSettings(settings);
+            ok('Configured statusLine in settings.json');
+            break;
+        }
+        case 'B': {
+            // Already ours — just update the script (already copied above)
+            ok('statusLine already configured for session-topics (updated script)');
+            break;
+        }
+        case 'C': {
+            // Another command exists — create wrapper
+            const origCmd = settings.statusLine.command;
+
+            // Backup original command
+            fs.writeFileSync(ORIG_CMD_FILE, origCmd, 'utf8');
+            info(`Backed up original statusLine command to .original-statusline-cmd`);
+
+            // Write wrapper
+            fs.writeFileSync(DEST_WRAPPER, WRAPPER_SCRIPT, 'utf8');
+            fs.chmodSync(DEST_WRAPPER, 0o755);
+            info('Created wrapper-statusline.sh');
+
+            // Update settings to use wrapper
+            settings.statusLine.command = WRAPPER_CMD;
+            writeSettings(settings);
+            ok('Configured statusLine wrapper (preserves your existing statusline)');
+            break;
+        }
+        case 'D': {
+            // statusLine exists but no valid command — treat as case A
+            settings.statusLine = {
+                type: 'command',
+                command: STATUSLINE_CMD,
+            };
+            writeSettings(settings);
+            ok('Configured statusLine in settings.json (replaced invalid entry)');
+            break;
+        }
+    }
+
+    // ── Step 5: Add permission ───────────────────────────────────────────
+
+    if (!settings.permissions || typeof settings.permissions !== 'object' || Array.isArray(settings.permissions)) {
+        settings.permissions = {};
+    }
+    if (!Array.isArray(settings.permissions.allow)) {
+        settings.permissions.allow = [];
+    }
+    if (!settings.permissions.allow.includes(PERMISSION_RULE)) {
+        settings.permissions.allow.push(PERMISSION_RULE);
+        writeSettings(settings);
+        ok(`Added permission: ${DIM}${PERMISSION_RULE}${RESET}`);
+    } else {
+        ok('Permission already present');
+    }
+
+    // ── Step 6: Copy skills ──────────────────────────────────────────────
+
+    const skillsToCopy = ['auto-topic', 'set-topic'];
+    for (const skill of skillsToCopy) {
+        const srcSkill = path.join(SRC_SKILLS, skill);
+        const destSkill = path.join(SKILLS_DIR, skill);
+        if (fs.existsSync(srcSkill)) {
+            copyDirRecursive(srcSkill, destSkill);
+            ok(`Installed skill: ${BOLD}${skill}${RESET}`);
+        } else {
+            warn(`Skill source not found: ${skill}`);
+        }
+    }
+
+    // ── Step 7: Configure color ──────────────────────────────────────────
+
+    if (color) {
+        fs.writeFileSync(COLOR_CONFIG, color, 'utf8');
+        ok(`Topic color set to: ${BOLD}${color}${RESET}`);
+    }
+
+    // ── Step 8: Summary ──────────────────────────────────────────────────
+
+    console.log('');
+    heading('Installation complete');
+    console.log(`  ${DIM}Statusline:${RESET}  ~/.claude/session-topics/statusline.sh`);
+    console.log(`  ${DIM}Skills:${RESET}      ~/.claude/skills/auto-topic/`);
+    console.log(`                ~/.claude/skills/set-topic/`);
+    console.log(`  ${DIM}Settings:${RESET}    ~/.claude/settings.json`);
+    if (color) {
+        console.log(`  ${DIM}Color:${RESET}       ${color}`);
+    }
+    console.log('');
+    console.log(`  Topics are set automatically. Use ${CYAN}/set-topic <text>${RESET} to override.`);
+    console.log('');
+}
+
+function determineStatusLineCase(settings) {
+    // Case B or C: statusLine exists
+    if (settings.statusLine && typeof settings.statusLine === 'object') {
+        const cmd = settings.statusLine.command;
+        if (typeof cmd === 'string' && cmd.length > 0) {
+            // Case B: already ours
+            if (cmd.includes('session-topics')) {
+                return 'B';
+            }
+            // Case C: another command
+            return 'C';
+        }
+        // statusLine exists but no valid command
+        return 'D';
+    }
+    // No statusLine at all
+    return 'A';
+}
+
+// ─── Uninstall ───────────────────────────────────────────────────────────────
+
+function uninstall() {
+    heading('Uninstalling claude-session-topics');
+
+    const settings = readSettings();
+
+    // ── Step 1: Restore statusline ───────────────────────────────────────
+
+    if (fs.existsSync(ORIG_CMD_FILE)) {
+        // Had a previous command — restore it
+        const origCmd = fs.readFileSync(ORIG_CMD_FILE, 'utf8').trim();
+        if (origCmd && settings.statusLine) {
+            settings.statusLine.command = origCmd;
+            writeSettings(settings);
+            ok(`Restored original statusLine command`);
+            info(`  ${origCmd}`);
+        }
+    } else {
+        // No backup — remove statusLine entirely if it's ours
+        if (
+            settings.statusLine &&
+            typeof settings.statusLine.command === 'string' &&
+            settings.statusLine.command.includes('session-topics')
+        ) {
+            delete settings.statusLine;
+            writeSettings(settings);
+            ok('Removed statusLine from settings.json');
+        } else if (settings.statusLine) {
+            info('statusLine does not reference session-topics — left untouched');
+        } else {
+            info('No statusLine to remove');
+        }
+    }
+
+    // ── Step 2: Delete scripts ───────────────────────────────────────────
+
+    const filesToDelete = [DEST_STATUSLINE, DEST_WRAPPER, ORIG_CMD_FILE];
+    for (const file of filesToDelete) {
+        if (fs.existsSync(file)) {
+            fs.unlinkSync(file);
+            ok(`Deleted ${path.basename(file)}`);
+        }
+    }
+
+    // ── Step 3: Remove permission ────────────────────────────────────────
+
+    if (
+        settings.permissions &&
+        typeof settings.permissions === 'object' &&
+        Array.isArray(settings.permissions.allow)
+    ) {
+        const before = settings.permissions.allow.length;
+        settings.permissions.allow = settings.permissions.allow.filter(
+            (rule) => rule !== PERMISSION_RULE
+        );
+        if (settings.permissions.allow.length < before) {
+            writeSettings(settings);
+            ok(`Removed permission: ${PERMISSION_RULE}`);
+        }
+    }
+
+    // ── Step 4: Delete skills ────────────────────────────────────────────
+
+    const skillsToDelete = ['auto-topic', 'set-topic'];
+    for (const skill of skillsToDelete) {
+        const skillDir = path.join(SKILLS_DIR, skill);
+        if (fs.existsSync(skillDir)) {
+            fs.rmSync(skillDir, { recursive: true, force: true });
+            ok(`Removed skill: ${skill}`);
+        }
+    }
+
+    // ── Step 5: Preserve data ────────────────────────────────────────────
+
+    info('Preserved topic data in ~/.claude/session-topics/ (topic files + color config)');
+
+    // ── Summary ──────────────────────────────────────────────────────────
+
+    console.log('');
+    heading('Uninstall complete');
+    console.log(`  Scripts and skills removed. Topic data preserved.`);
+    console.log(`  To fully remove all data: ${DIM}rm -rf ~/.claude/session-topics/${RESET}`);
+    console.log('');
+}
+
+// ─── Main ────────────────────────────────────────────────────────────────────
+
+function main() {
+    const { action, color } = parseArgs(process.argv);
+
+    switch (action) {
+        case 'help':
+            showHelp();
+            break;
+        case 'install':
+            install(color);
+            break;
+        case 'uninstall':
+            uninstall();
+            break;
+        default:
+            showHelp();
+            break;
+    }
+}
+
+main();

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@alexismunozdev/claude-session-topics",
+  "version": "2.0.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/",
+    "scripts/",
+    "skills/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "statusline",
+    "topic",
+    "session",
+    "productivity"
+  ],
+  "author": "Alexis Muñoz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alexismunoz1/claude-session-topics.git"
+  },
+  "homepage": "https://github.com/alexismunoz1/claude-session-topics"
+}

package/scripts/statusline.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+set -euo pipefail
+
+input=$(cat)
+
+# ── Parse JSON
+SESSION_ID=$(echo "$input" | jq -r '.session_id // ""')
+
+# ── PID→Session bridge
+if [ -n "$SESSION_ID" ]; then
+    echo "$SESSION_ID" > "/tmp/claude-pid-${PPID}"
+fi
+
+# ── Pick up pending topic from /set-topic
+PENDING="/tmp/claude-pending-topic-${PPID}"
+if [ -n "$SESSION_ID" ] && [ -f "$PENDING" ]; then
+    PENDING_TOPIC=$(cat "$PENDING" 2>/dev/null || echo "")
+    if [ -n "$PENDING_TOPIC" ]; then
+        mkdir -p "$HOME/.claude/session-topics"
+        echo "$PENDING_TOPIC" > "$HOME/.claude/session-topics/${SESSION_ID}"
+        rm -f "$PENDING"
+    fi
+fi
+
+# ── Topic
+TOPIC=""
+if [ -n "$SESSION_ID" ]; then
+    TOPIC_FILE="$HOME/.claude/session-topics/${SESSION_ID}"
+    if [ -f "$TOPIC_FILE" ]; then
+        TOPIC=$(cat "$TOPIC_FILE" 2>/dev/null || echo "")
+    fi
+fi
+if [ -z "$TOPIC" ] && [ -n "${CLAUDE_SESSION_TOPICS_TOPIC:-}" ]; then
+    TOPIC="$CLAUDE_SESSION_TOPICS_TOPIC"
+    if [ -n "$SESSION_ID" ]; then
+        mkdir -p "$HOME/.claude/session-topics"
+        echo "$TOPIC" > "$HOME/.claude/session-topics/${SESSION_ID}"
+    fi
+fi
+
+# ── Resolve topic color
+resolve_color() {
+    case "$1" in
+        red)       echo '\033[31m' ;;
+        green)     echo '\033[32m' ;;
+        yellow)    echo '\033[33m' ;;
+        blue)      echo '\033[34m' ;;
+        magenta)   echo '\033[35m' ;;
+        cyan)      echo '\033[36m' ;;
+        white)     echo '\033[37m' ;;
+        orange)    echo '\033[38;5;208m' ;;
+        grey|gray) echo '\033[90m' ;;
+        "")        echo '\033[35m' ;;  # default: magenta
+        *)
+            if echo "$1" | grep -qE '^[0-9;]+$'; then
+                echo "\033[${1}m"
+            else
+                echo '\033[35m'
+            fi
+            ;;
+    esac
+}
+# Color priority: env var > config file > default (magenta)
+_color="${CLAUDE_SESSION_TOPICS_COLOR:-}"
+if [ -z "$_color" ] && [ -f "$HOME/.claude/session-topics/.color-config" ]; then
+    _color=$(cat "$HOME/.claude/session-topics/.color-config" 2>/dev/null || echo "")
+fi
+C_TOPIC=$(resolve_color "$_color")
+C_BOLD='\033[1m'
+C_RESET='\033[0m'
+
+# ── Cleanup stale files (atomic lock)
+CLEANUP_LOCK="/tmp/.claude-topic-cleanup-lock"
+if mkdir "$CLEANUP_LOCK" 2>/dev/null; then
+    trap "rmdir '$CLEANUP_LOCK' 2>/dev/null || true" EXIT
+    find "$HOME/.claude/session-topics" -type f -mtime +7 -delete 2>/dev/null || true
+    find /tmp -maxdepth 1 -name "claude-pid-*" -mtime +1 -delete 2>/dev/null || true
+    find /tmp -maxdepth 1 -name "claude-pending-topic-*" -mtime +1 -delete 2>/dev/null || true
+    rmdir "$CLEANUP_LOCK" 2>/dev/null
+fi
+
+# ── Output
+if [ -n "$TOPIC" ]; then
+    echo -e "${C_BOLD}${C_TOPIC}◆ ${TOPIC}${C_RESET}"
+fi

package/skills/auto-topic/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: auto-topic
+description: Use on EVERY user message to automatically set or update a short session topic (2-4 words) in the statusline. Activates continuously throughout the conversation to keep the topic current as the discussion evolves.
+version: 1.2.0
+allowed-tools: [Bash]
+---
+
+# Auto Topic
+
+Automatically set and update a short, descriptive topic for the current Claude Code session as the conversation evolves.
+
+## When to Activate
+
+This skill activates on **every user message**. Run it silently — do not mention to the user that you are setting or updating the topic.
+
+## Rules
+
+1. After reading each user message, infer a topic of **2-4 words** (max 20 characters) that reflects what the user is currently working on
+2. The topic should summarize the current focus of the conversation
+3. Use the project's domain language (e.g., Spanish is fine if the user writes in Spanish)
+4. Examples: "Auth Refactor", "FAQ Bug", "Search Filters", "DB Migration", "API Tests"
+5. Run the topic check and update **silently** — do not tell the user you set or changed it
+6. If `/set-topic` is used later by the user, that takes priority
+
+## How to Check and Update the Topic
+
+### Step 1: Read the current topic
+
+```bash
+SESSION_ID=$(cat /tmp/claude-pid-$PPID 2>/dev/null)
+if [ -n "$SESSION_ID" ]; then
+    TOPIC_FILE="$HOME/.claude/session-topics/${SESSION_ID}"
+    CURRENT_TOPIC=$(cat "$TOPIC_FILE" 2>/dev/null || echo "")
+    echo "Current topic: '$CURRENT_TOPIC'"
+fi
+```
+
+### Step 2: Decide whether to update
+
+Compare the inferred new topic with the current topic. **Only write a new topic if the conversation has clearly shifted to a different subject.** Do NOT update for:
+- Minor variations of the same topic (e.g., "Auth Refactor" → "Refactor Auth")
+- Subtasks within the same broader topic (e.g., "Auth Refactor" → "Auth Tests" if still working on auth)
+- Rewording without a real subject change
+
+DO update when:
+- The user has moved to a genuinely different area of work (e.g., "Auth Refactor" → "DB Migration")
+- The original topic no longer describes what the conversation is about
+- There is no current topic yet (first message)
+
+### Step 3: Write the new topic (only if changed)
+
+If the topic has meaningfully changed, run:
+
+```bash
+SESSION_ID=$(cat /tmp/claude-pid-$PPID 2>/dev/null)
+if [ -n "$SESSION_ID" ]; then
+    mkdir -p "$HOME/.claude/session-topics"
+    echo "Your New Topic" > "$HOME/.claude/session-topics/${SESSION_ID}"
+fi
+```
+
+Replace `Your New Topic` with the inferred 2-4 word topic.
+
+If the topic has NOT meaningfully changed, **do nothing** — skip the write entirely.
+
+## Important
+
+- Run this on **every** user message, but only write when the topic has genuinely changed
+- Do NOT mention the topic to the user — ever
+- Keep topics short and descriptive (2-4 words, max 20 characters)
+- If the statusline hasn't run yet (no PID file), skip silently
+- A high bar for "meaningfully changed" prevents unnecessary churn — when in doubt, keep the current topic

package/skills/set-topic/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: set-topic
+description: Set or change the session topic displayed in the statusline
+argument-hint: <topic text>
+allowed-tools: [Bash]
+version: 1.1.0
+---
+
+# Set Topic
+
+Set or change the topic displayed in the Claude Code statusline.
+
+## Usage
+
+`/set-topic <topic text>`
+
+## Instructions
+
+1. The topic text is: $ARGUMENTS
+2. If the topic text is empty, inform the user they need to provide a topic (e.g., `/set-topic Auth Refactor`)
+3. Run this bash command to discover the session ID and write the topic file:
+
+```bash
+SESSION_ID=$(cat /tmp/claude-pid-$PPID 2>/dev/null)
+if [ -n "$SESSION_ID" ]; then
+    mkdir -p "$HOME/.claude/session-topics"
+    echo "$ARGUMENTS" > "$HOME/.claude/session-topics/${SESSION_ID}"
+    echo "Topic set to: $ARGUMENTS"
+else
+    echo "$ARGUMENTS" > "/tmp/claude-pending-topic-$PPID"
+    echo "Topic queued: $ARGUMENTS (will appear on next statusline refresh)"
+fi
+```
+
+4. Confirm to the user that the topic has been set and will appear in the statusline.