Synapse: Skill for Claude Code

Project-Scoped Insights

Analyze session history filtered to the CURRENT project only. Prevents cross-project context pollution.

Instructions

1. Detect Scope

Determine the current working directory. This is your project scope. Extract the project name from the last path segment.

Check for a --broad flag in the user's invocation. If present, include sessions whose project_path is a parent of the current directory (e.g., C:\Users\User sessions when running from C:\Users\User\SYNAPSE). Default behavior: strict match only.

2. Read Session Metadata

Read ALL .json files from ~/.claude/usage-data/session-meta/. Each file contains:

• session_id — UUID matching the filename
• project_path — Working directory when the session ran
• start_time, duration_minutes, user_message_count, assistant_message_count
• tool_counts — Object of tool name to usage count
• languages — Object of language name to file count
• git_commits, git_pushes, lines_added, lines_removed, files_modified
• first_prompt — Truncated first user message

Use the Bash tool to read all files efficiently:

python -c "
import json, glob, os
sessions = []
for f in glob.glob(os.path.expanduser('~/.claude/usage-data/session-meta/*.json')):
    with open(f, encoding='utf-8') as fh:
        sessions.append(json.load(fh))
print(json.dumps(sessions))
"

3. Filter to Current Project

Apply the filter:

• Strict (default): Keep sessions where project_path exactly equals the current working directory (case-insensitive, normalize path separators)
• Broad (--broad): Also include sessions where the current working directory starts with project_path (i.e., project_path is a parent directory)

Use Python for filtering:

python -c "
import json, sys, os

cwd = os.getcwd().replace('/', os.sep).rstrip(os.sep).lower()
broad = '--broad' in sys.argv
sessions = json.loads(sys.argv[-1])

matched = []
for s in sessions:
    sp = s.get('project_path', '').replace('/', os.sep).rstrip(os.sep).lower()
    if sp == cwd:
        matched.append(s)
    elif broad and cwd.startswith(sp + os.sep):
        matched.append(s)

print(json.dumps(matched, indent=2))
" [BROAD_FLAG] '[SESSION_JSON]'