penspanic

Claude Session Kit — AI skill for Claude Code

AI community

Mine your Claude Code sessions for patterns.

How to install Claude Session Kit

This entry records only its repository, not the path inside it, so there is no exact command to give. Open penspanic/claude-session-kit and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Session Kit does

Mine your Claude Code sessions for patterns. Incremental backup + LLM summaries + cross-session finding detection — missing skills, codebase smells, doc gaps — grounded in real session evidence.

Alternatives in AI

Internal Safety Collapse — We built an adversarial codespace setup 1.2k ★
Openclaw Backup — One-click backup & restore for OpenClaw instances — workspace, credentials, skills, agent history 660 ★
Engineering Notebook — A Bun CLI that ingests Claude Code and Codex session transcripts, generates LLM-powered daily summaries, and s 320 ★

README

claude-session-kit

Mine your Claude Code sessions for patterns. Back up every session, summarize each one with an LLM, then cross-reference across sessions to surface recurring friction, missing skills, codebase smells, documentation gaps, and test coverage holes — every finding cites the real sessions it came from.

[![npm](https://img.shields.io/npm/v/claude-session-kit.svg)](https://www.npmjs.com/package/claude-session-kit) [![CI](https://github.com/penspanic/claude-session-kit/actions/workflows/ci.yml/badge.svg)](https://github.com/penspanic/claude-session-kit/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

flowchart LR
  jsonl["~/.claude/projects/
*.jsonl
deleted after 30d"]

  subgraph csk["claude-session-kit"]
    direction TB
    backup["csk backup"] --> store[("SQLite index
+ blob mirror
+ FTS5 search")]
    store --> analyze["csk analyze
per-session LLM summary
intent · friction · corrections"]
    analyze --> patterns["csk patterns
project / global
cross-session findings"]
  end

  jsonl --> backup

  findings["Findings
• repetition / skill_gap
• correction_pattern
• codebase_smell / api_friction
• documentation_gap / test_coverage_gap

→ CLAUDE.md · new skill · refactor · docs · tests"]
  patterns --> findings

  surfaces["CLI  |  Web dashboard (csk serve)  |  MCP server (agents)"]
  store --- surfaces
  findings --- surfaces

Why

Your Claude Code sessions are the highest-signal record of how you *actually* work with an AI — every correction you made, every time the assistant got stuck on the same thing, every recurring intent. But:

They disappear. Claude Code deletes sessions after 30 days by default (cleanupPeriodDays).
One session tells you what happened that time. The interesting signal — "I keep redirecting the assistant away f