Manage Claude Code hooks in /specmem/claude-hooks/.

COMMAND PARSING

Parse what comes after /specmem-hooks:

const args = "$ARGUMENTS".trim();

if (!args || args === "help" || args === "--help" || args === "-h") {
  // Show HELP below
  return;
}

if (args === "list") {
  // Execute LIST action
  return;
}

if (args === "status") {
  // Execute STATUS action
  return;
}

if (args === "deploy") {
  // Execute DEPLOY action
  return;
}

if (args === "scan") {
  // Execute SCAN action
  return;
}

// Unknown command
console.log("Unknown command. Use /specmem-hooks help for usage.");

HELP OUTPUT

If no args or "help":

SpecMem Hooks - Hook Management

USAGE:
  /specmem-hooks              Show this help
  /specmem-hooks list         List all hooks with descriptions
  /specmem-hooks status       Show hook system status
  /specmem-hooks deploy       Deploy enabled hooks to ~/.claude/hooks/
  /specmem-hooks scan         Scan claude-hooks directory

HOOKS DIRECTORY:
  Source: /specmem/claude-hooks/
  Target: ~/.claude/hooks/

HOOK TYPES:
  .js  - Node.js hooks (PreToolUse, PostToolUse, etc.)
  .py  - Python hooks
  .sh  - Shell script hooks
  .cjs - CommonJS hooks

AVAILABLE HOOKS:
  agent-loading-hook.js           Configures agent deployment
  agent-output-interceptor.js     Intercepts agent output
  agent-type-matcher.js           Matches agent types
  background-completion-silencer.js  Silences background completions
  bash-auto-background.js         Auto-backgrounds long Bash commands
  input-aware-improver.js         Improves prompts based on context
  smart-context-hook.js           Smart context injection
  smart-search-interceptor.js     Intercepts search operations
  specmem-context-hook.js         Injects SpecMem context into prompts
  specmem-drilldown-hook.js       Enforces drilldown after searches
  specmem-precompact.js           Precompacts responses
  specmem-session-start.cjs       Session initialization
  specmem-team-member-inject.js   Injects team member coordination
  specmem-unified-hook.py         Unified Python hook for all events
  subagent-loading-hook.js        Configures subagent loading
  task-progress-hook.js           Tracks task progress

RELATED:
  /specmem-stats    View system statistics
  /specmem          Main SpecMem commands

NOTE: This command does NOT use MCP tools.
      It manages files in the hooks directory using Bash.

EXECUTION

For "list"

Execute this bash command:

echo "=== SPECMEM HOOKS ===" && \
echo "" && \
for f in /specmem/claude-hooks/*.{js,py,sh,cjs} 2>/dev/null; do \
  if [ -f "$f" ]; then \
    echo "$(basename "$f")" && \
    head -3 "$f" | grep -E "^(//|#)" | sed 's/^/  /' && \
    echo ""; \
  fi; \
done

Display the output showing each hook file with its description from comments.

For "status"

Execute these bash commands:

echo "=== HOOK SYSTEM STATUS ===" && \
echo "" && \
echo "Source Directory: /specmem/claude-hooks/" && \
ls -1 /specmem/claude-hooks/*.{js,py,sh,cjs} 2>/dev/null | wc -l | xargs -I{} echo "Total Hooks: {}" && \
echo "" && \
echo "Target Directory: ~/.claude/hooks/" && \
if [ -d ~/.claude/hooks/ ]; then \
  ls -la ~/.claude/hooks/; \
else \
  echo "(not found - run deploy)"; \
fi && \
echo "" && \
echo "Recent Hook Activity:" && \
ls -lt /specmem/claude-hooks/*.{js,py,sh,cjs} 2>/dev/null | head -5 | awk '{print "  " $6, $7, $8, $9}'

For "deploy"

Execute these bash commands:

mkdir -p ~/.claude/hooks && \
echo "Deploying hooks to ~/.claude/hooks/..." && \
cp /specmem/claude-hooks/*.js ~/.claude/hooks/ 2>/dev/null; \
cp /specmem/claude-hooks/*.cjs ~/.claude/hooks/ 2>/dev/null; \
cp /specmem/claude-hooks/*.py ~/.claude/hooks/ 2>/dev/null; \
cp /specmem/claude-hooks/*.sh ~/.claude/hooks/ 2>/dev/null; \
chmod +x ~/.claude/hooks/* 2>/dev/null && \
echo "" && \
echo "Deployed hooks:" && \
ls -la ~/.claude/hooks/

Report success or failure.

For "scan"

Execute this bash command:

echo "=== SCANNING HOOKS ===" && \
echo "" && \
echo "JavaScript Hooks:" && \
ls -la /specmem/claude-hooks/*.js 2>/dev/null || echo "  (none)" && \
echo "" && \
echo "CommonJS Hooks:" && \
ls -la /specmem/claude-hooks/*.cjs 2>/dev/null || echo "  (none)" && \
echo "" && \
echo "Python Hooks:" && \
ls -la /specmem/claude-hooks/*.py 2>/dev/null || echo "  (none)" && \
echo "" && \
echo "Shell Hooks:" && \
ls -la /specmem/claude-hooks/*.sh 2>/dev/null || echo "  (none)"

HOOK DESCRIPTIONS

Brief descriptions for common hooks:

agent-loading-hook.js - Configures model/settings for agent deployment based on .specmem/agent-config.json
agent-output-interceptor.js - Processes agent output for special formatting
bash-auto-background.js - Automatically backgrounds long-running Bash commands
input-aware-improver.js - Analyzes input and suggests improvements
smart-context-hook.js - Injects relevant SpecMem context into prompts
specmem-context-hook.js - Adds SpecMem memories to conversation context
specmem-drilldown-hook.js - Reminds user to drilldown after memory searches
specmem-team-member-inject.js - Adds team coordination instructions
task-progress-hook.js - Tracks and displays task progress

MCP TOOLS USED

NONE - This command uses Bash exclusively for file operations.

EXAMPLES

List all hooks

/specmem-hooks list

Check hook system status

/specmem-hooks status

Deploy hooks to Claude

/specmem-hooks deploy

Scan for new hooks

/specmem-hooks scan

SpecMem Hooks - Custom Hook Management