Skip to content
SkillModel-led914 tokens in use

session-brain

Builds a searchable, browser-viewable topic graph over your agent session history with local clustering, then names each cluster in a single turn.

3,792 stars on the repository MIT LicenseAr9av/obsidian-wiki · skills/session-brain
pip install obsidian-wiki
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing session-brain costs

59tokens idle
914tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure15/25
  • Examples9/15
  • Output10/15
  • Size15/15
  • Resources10/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 26

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity100
  • Maintenance100
  • Community60
  • Maturity28
  • Momentum40

session-brain indexes your Claude session history into a graph of topics. The heavy work is deterministic Python in the obsidian-wiki command line tool: it reads transcripts, links similar sessions and groups them into clusters. The agent only adds a short name and one-sentence summary for each cluster that has none yet.

The output is a sidecar folder at ~/.claude/session-brain, including a graph.html you can open in a browser. It reports the biggest topics, what is heating up, what has gone quiet and which sessions bridge two topics.

What You Get

  • A topic graph of your session history stored in a sidecar folder, with a graph.html viewer
  • Short names and summaries for every cluster, kept across rebuilds
  • A report of the biggest topics, the hottest momentum, dormant topics and bridge sessions
  • Tuning flags for stricter edges, mutual-neighbour clusters, recency half-life and per-project exclusion
  • A clear count of sessions that have transcripts and sessions that only survive as prompts

Common Use Cases

  • Getting a map of what you have worked on across hundreds of agent sessions
  • Spotting topics that have gone quiet for two months or more
  • Finding sessions that connect two otherwise separate topics

What Makes It Unique

Naming costs one turn whatever the size of the history, because the tool hands over top terms and exemplar titles and the agent never opens a transcript for it. The viewer encodes session length as node size, recency as brightness, history-only sessions as hollow rings and bookmarked sessions as gold borders, with a time slider and search box. It is explicitly a sidecar and does not touch the vault.

Under The Hood

The skill is instructions that run the obsidian-wiki command line tool through the shell: sessions-build, sessions-clusters and sessions-name, with names passed in through a heredoc. The tool reads Claude session transcripts and the prompt history file on disk and writes graph, cluster and name files under ~/.claude/session-brain. The skill also runs the open command to show graph.html in a browser. It does not fetch web pages or call remote APIs, and it does not write to the wiki vault.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers