wide-probe · Claude Code mod

README

<samp>install · the pane · privacy · roadmap · changelog</samp>

<samp>After a long turn, nobody can say without scrolling back what Claude actually has in context. cc-graph is a Claude Code mod that draws it in a live pane beside the conversation: every file Claude read, searched or changed, how those files import each other, and what compaction took away.</samp>

/plugin install cc-graph --marketplace kuehn-lars/cc-graph

<samp>Then type /graph. Needs Claude Code v2.1.287 or later, in the terminal.</samp>

<samp>control</samp>	<samp>what it does</samp>
<kbd>g</kbd>	<samp>graph view</samp>
<kbd>l</kbd>	<samp>list view</samp>
<kbd>1</kbd> … <kbd>9</kbd>	<samp>pick a row in the list</samp>
`maxNodes` = `60`	<samp>most files in the graph, in /config</samp>
`importEdges` = `on`	<samp>show file imports, in /config</samp>
`blindSpots` = `on`	<samp>look for blind spots with git, in /config</samp>
`captureThinking` = `on`	<samp>keep thinking excerpts, in /config</samp>

<samp>Files a shell command created, deleted or changed show too, named with the command that did it, and so do files Claude read with cat, head or sed -n. Files that import a change but were never opened are flagged as blind spots while the turn is still running.</samp>

<samp>The list also shows Claude's newest thinking: a short excerpt per step, with its turn and the files that step read or changed. Claude Code passes thinking text to mods only when "showThinkingSummaries": true is in your settings (or with --thinking-display summarized). This holds for every 5.5 model: Opus, Sonnet and Haiku. Without it, the footer says thinking is hidden.</samp>

<samp>cc-graph only watches. Its hooks pass every tool result on untouched and record what happened in session memory.</samp>

<samp>Nothing leaves your machine. No network requests, no model calls, no files written.</samp>
<samp>Paths, sizes and counts, never file contents. The one exception is Claude's newest 20 thinking excerpts, at most 400 characters each, and only while captureThinking is on. All of it is gone when the conversation ends or on /clear.</samp>
<samp>The only process it starts is read-only git, by argument list, never through a shell.</samp>
<samp>Check it yourself: claude plugin validate lists every event cc-graph hooks and every API method it calls. CI fails if the code goes beyond the allowed list.</samp>

<samp>Features, exit gates and spikes per milestone are in ROADMAP.md.</samp>

<samp>The project is spec-driven: specs/ is the source of truth, and each feature goes from spec to failing tests to code. Instructions for Claude Code working on this repository are in CLAUDE.md.</samp>

claude --plugin-dir .          # run with the mod loaded (use a copy of fixtures/sample-app)
npx tsc -p . && claude plugin test && node scripts/check-calls.mjs
node scripts/trace.mjs --check # every approved acceptance criterion has a test

Source 1 files

hooks/register.tsx 21 lines

1// Throwaway recording probe for fixtures/sessions/wide.ts and many-changes.ts (see ../../README.md). Not part of the mod.
2// It logs session.start, turn.start and every tool.call as the hooks see them, and changes nothing.
3import type { Register } from 'claude-code'
4
5const OUT = '/tmp/cc-graph-wide/log-' + Date.now() + '.json'
6const rows: any[] = []
7const log = async ($: any, event: string, e: any, next: any) => {
8  const row: any = { event, input: e }
9  rows.push(row)
10  const out = await next(e)
11  row.result = out
12  await $.fs.write(OUT, JSON.stringify(rows, null, 1))
13  return out
14}
15
16export const register: Register = on => {
17  on('session.start', ($, e: any, next: any) => log($, 'session.start', e, next)).catch(($, e, next) => next(e))
18  on('turn.start', ($, e: any, next: any) => log($, 'turn.start', e, next)).catch(($, e, next) => next(e))
19  on('tool.call', ($, e: any, next: any) => log($, 'tool.call', e, next)).catch(($, e, next) => next(e))
20}
21