explaingit

juntoku9/sessory

23TypeScriptAudience · developerComplexity · 2/5Setup · easy

TLDR

A TypeScript tool that automatically captures Claude Code session transcripts, classifies them by work type, stores them in a local SQLite database, and surfaces everything through a searchable web dashboard.

Mindmap

mindmap
  root((repo))
    What it does
      Captures transcripts
      Classifies sessions
      Runs local dashboard
    Storage
      SQLite local
      Postgres for teams
    Dashboard tabs
      Session browser
      Skills tab
      Table view
      Settings
    Session data
      Work type label
      Files touched
      Errors hit
      Significance score
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automatically record every Claude Code session and later search past sessions by file, command, or error text to recall how a problem was solved.

USE CASE 2

Filter sessions by significance score to surface only the sessions where difficult problems were worked through and corrected.

USE CASE 3

Share a team-wide searchable archive of AI coding sessions by switching the backend from local SQLite to a shared Postgres database.

Tech stack

TypeScriptSQLitePostgreSQLNode.js

Getting it running

Difficulty · easy Time to first run · 5min

Single npm command for setup, the capture hook fires automatically after each Claude Code session ends with nothing else to configure.

No license information is mentioned in the explanation.

In plain English

Sessory is a tool for developers who use AI coding assistants and want to keep a record of what happened during each session. When you finish a session with Claude Code, a hook fires automatically, reads the session transcript, and saves a structured summary to a local database on your machine. The idea is that git commits show what changed in the code, but they do not show the AI's reasoning, the errors it hit, or how it corrected course. Sessory captures that information and makes it searchable. After a one-time setup using a single npm command, the capture runs on its own every time a session ends. The process has four steps: it reads the transcript, stores a row in a local SQLite file at a fixed path on your computer, calls a background AI classification step that extracts a structured summary, and then makes all of that available through a local web dashboard. Nothing is sent anywhere, the data stays on your machine by default. Each saved session includes a label for what kind of work it was (bug fix, refactor, test writing, and so on), a status indicating whether the work was completed or abandoned, the files touched, commands run, errors encountered, and a structured insight field covering what the bottleneck was and how problems were corrected. A significance score between 0 and 1 lets you filter out trivial sessions. The dashboard has four tabs: a session browser with full traces, a skills tab showing which AI slash commands were used across sessions, a table view for sorting and filtering everything, and a settings panel. You can search by file, command, error text, or tags. For teams, Sessory supports swapping the SQLite backend for a shared Postgres database by setting a single environment variable. That lets multiple developers write their sessions to one place so the shared archive is searchable across the team. Per-developer access control and secret redaction are listed as future work.

Copy-paste prompts

Prompt 1
I just installed Sessory with npm and want to verify the hook is firing correctly. Show me how to check that sessions are being saved and explain what the key columns in the SQLite schema mean.
Prompt 2
Using the Sessory dashboard, help me construct a search or filter that finds all sessions where a TypeError was encountered and the session status was eventually marked complete.
Prompt 3
I want to switch Sessory from local SQLite to a shared Postgres database for my team. What environment variable do I set and does the schema migrate automatically or do I need to run a script?
Prompt 4
In Sessory, what does the significance score between 0 and 1 represent and how do I configure the dashboard to show only sessions scored above 0.7?
Open on GitHub → Explain another repo

← juntoku9 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.