fleet-memory/hindsight-integrations/claude-code/scripts/setup_hooks.py
Ben 22ca6a8d73
fix: add setup_hooks.py and hindsight:setup skill for hook registration (#690)
Claude Code's plugin installer does not merge hooks.json into settings.json
automatically. This adds a setup script and skill that users can run once
after installing the plugin to register the hooks manually.
2026-03-25 16:59:25 +01:00

115 lines
3.3 KiB
Python

#!/usr/bin/env python3
"""Register hindsight-memory hooks into ~/.claude/settings.json.
Claude Code's plugin installer does not currently merge hooks.json into
settings.json automatically. Run this script once after installing the plugin:
python3 setup_hooks.py
Or via the /hindsight:setup skill inside a Claude Code session.
"""
import json
import os
import sys
SETTINGS_PATH = os.path.expanduser("~/.claude/settings.json")
def find_plugin_root() -> str:
"""Locate the installed hindsight-memory plugin cache directory."""
cache_base = os.path.expanduser("~/.claude/plugins/cache/hindsight/hindsight-memory")
if not os.path.isdir(cache_base):
raise RuntimeError(
"hindsight-memory plugin not found. "
"Run /plugin install hindsight-memory inside Claude Code first."
)
versions = sorted(os.listdir(cache_base), reverse=True)
if not versions:
raise RuntimeError(f"No versions found in {cache_base}")
return os.path.join(cache_base, versions[0])
def build_hooks(plugin_root: str) -> dict:
return {
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": f'python3 "{plugin_root}/scripts/recall.py"',
"timeout": 12,
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": f'python3 "{plugin_root}/scripts/retain.py"',
"timeout": 15,
"async": True,
}
]
}
],
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": f'python3 "{plugin_root}/scripts/session_start.py"',
"timeout": 5,
}
]
}
],
"SessionEnd": [
{
"hooks": [
{
"type": "command",
"command": f'python3 "{plugin_root}/scripts/session_end.py"',
"timeout": 10,
}
]
}
],
}
def main():
try:
plugin_root = find_plugin_root()
except RuntimeError as e:
print(f"Error: {e}", file=sys.stderr)
sys.exit(1)
if not os.path.isfile(SETTINGS_PATH):
print(f"Error: {SETTINGS_PATH} not found. Is Claude Code installed?", file=sys.stderr)
sys.exit(1)
with open(SETTINGS_PATH) as f:
settings = json.load(f)
existing_hooks = settings.get("hooks", {})
if existing_hooks:
print("Existing hooks found — merging (hindsight-memory hooks take precedence).")
new_hooks = build_hooks(plugin_root)
merged = {**existing_hooks, **new_hooks}
settings["hooks"] = merged
settings.setdefault("env", {})["CLAUDE_PLUGIN_ROOT"] = plugin_root
with open(SETTINGS_PATH, "w") as f:
json.dump(settings, f, indent=2)
print(f"hindsight-memory hooks registered successfully.")
print(f"Plugin root: {plugin_root}")
print(f"Restart Claude Code for changes to take effect.")
if __name__ == "__main__":
main()