Skip to content

Commit b889e61

Browse files
cdeustclaude
andcommitted
docs(readme): new hero screenshot + workflow-graph section
Replaced the legacy banner with the live workflow-graph screenshot — many brain-region clouds, one per project, with the radial hierarchy legend overlaid. It's the single image that communicates what Cortex actually produces. Rewrote the "Neural Graph" section around the redesigned UI: - Graph is the default landing view (not Wiki); table enumerates the five layers (L1 setup · L2 tools · L3 files · L4 discussions · L5 memories) with what you click to drill in. - L3 files: explains the primary-tool color coding + the See-diff-against- HEAD button that renders new/modified/deleted/historical content inline. - L4 discussions: View-full-conversation modal with full turn replay. - Cross-domain dashed violet threads called out explicitly. - Mentions the grouped filter select (All / L1-L5 / by kind / by file cluster / cross-domain) + text search. - Board section updated with the live bucket metrics header (decay, vulnerability, plasticity, heat, importance, encoding, interference, hippo, replay) and the advancement rule under each column. - Detail-panel paragraph added — every scientific measurement now comes with a plain-language explanation. Hero + two supporting screenshots now live under ``docs/assets/``: - cortex-workflow-graph.png (hero, full graph + stats + legend) - cortex-consolidation-board.png (Board view with per-stage metrics) - cortex-memory-detail.png (memory detail with Scientific measurements) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 3581af3 commit b889e61

4 files changed

Lines changed: 28 additions & 22 deletions

File tree

README.md

Lines changed: 28 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<img src="assets/banner.svg" alt="Cortex — persistent memory for Claude Code" width="100%"/>
2+
<img src="docs/assets/cortex-workflow-graph.png" alt="Cortex workflow graph — every project becomes a brain-region cloud; nodes cluster by the Claude surface that touched them (skills, hooks, commands, agents, tools, files, memories, discussions); thin long-range threads mark shared files and shared MCPs between clouds" width="100%"/>
33
</p>
44

55
<p align="center">
@@ -263,7 +263,7 @@ Anchored memories get maximum protection. They always survive compaction, no mat
263263
Every time you store a memory, Cortex doesn't just save text — it extracts entities, builds relationships, detects schemas, and links the new memory into a growing knowledge graph. Over time, this becomes a **living wiki of your project**: decisions and their rationale, patterns that emerged, lessons learned, architectural constraints, and how they all connect.
264264

265265
Explore it through:
266-
- **`/cortex-visualize`** — interactive neural graph in your browser
266+
- **`/cortex-visualize`**opens the interactive workflow graph in your browser (Graph is the default view; Knowledge / Wiki / Board / Pipeline tabs over the same data)
267267
- **`get_causal_chain`** — trace how one decision led to another
268268
- **`get_project_story`** — auto-generated narrative of your project's evolution
269269
- **`detect_gaps`** — find areas where knowledge is thin or isolated
@@ -274,42 +274,48 @@ This isn't documentation you write. It's documentation that writes itself from h
274274

275275
## Neural Graph
276276

277-
Launch with `/cortex-visualize`. Five views wired over the same data:
277+
Launch with `/cortex-visualize`. The default landing view is **Graph** — a live, radial-hierarchical map of everything Claude has ever done in your projects. Knowledge / Wiki / Board / Pipeline tabs sit over the same data for different reading angles.
278278

279279
<p align="center">
280-
<img src="docs/neural-graph-overview.png" width="100%" alt="Cortex Neural Graphforce-directed view with domain clusters, memories, entities, and discussions" />
280+
<img src="docs/assets/cortex-workflow-graph.png" width="100%" alt="Cortex workflow graphmany brain-region clouds, one per project, with inner radial shells grouping nodes by Claude surface (setup → tools → files → discussions → memories)" />
281281
</p>
282282

283-
**Graph View** — force-directed neural graph showing domain clusters, memories, entities, and discussions connected by typed edges. Click any node for full context.
283+
**Graph View — the Claude workflow map.** Each project becomes a **cloud of nodes** around one gold domain hub. Inside every cloud, nodes are arranged in five concentric levels by the Claude surface that produced them:
284284

285-
<p align="center">
286-
<img src="docs/neural-graph-wiki.png?v=3" width="100%" alt="Cortex Wiki — a Convention page rendered with LaTeX typography showing Edit + Export toolbar (PDF/TEX/DOCX/HTML), active lifecycle pill, heat bar, structured numbered sections authored via the in-browser editor" />
287-
</p>
285+
| Level | What's there | How to click through |
286+
|---|---|---|
287+
| **L1 · Claude setup** | Skills · Commands · Hooks · Agents · MCPs | Click a skill for its file path; click an MCP to see which domains share it (thin indigo threads bridge clouds) |
288+
| **L2 · Tools** | One hub per Claude tool per domain (Edit · Write · Read · Grep · Glob · Bash · Task) | Click a hub for files touched + total uses |
289+
| **L3 · Files** | Every file Claude ever opened, read, edited, searched, or referenced in a Bash command — colored by primary tool (green edited / cyan read / fuchsia searched / orange bash-only) | Click for `first_seen`, `last_accessed`, `last_modified`, and a **See diff against HEAD** button that renders new/modified/deleted/historical content inline |
290+
| **L4 · Discussions** | One node per Claude Code session | Click for `started_at`, duration, message count, and a **View full conversation** button that replays every turn (including tool calls) |
291+
| **L5 · Memories** | Persistent memories, colored by consolidation stage (labile → early LTP → late LTP → consolidated → semantic) | Click for full content, tags, and every scientific measurement |
288292

289-
**Wiki View** — every memory admitted by the grounded-theory pipeline lands here as a structured page (ADR / spec / lesson / convention / note) with:
293+
Thin dashed **violet threads** between clouds mark cross-domain files and shared MCPs. A single **grouped filter select** (`All` / `L1–L5` / by kind / by file cluster / `Cross-domain`) isolates any slice; a text search narrows within that slice.
290294

291-
- EB Garamond body, IBM Plex Mono code, centered academic-paper layout
292-
- **Heat bar**, lifecycle pill (`active` / `area` / `archived` / `evergreen`), staleness flag, backlinks footer
293-
- **Inspector drawer** — full audit trail (memos, source claim events, draft history) for every page
294-
- **Inline CodeMirror 6 editor** + live preview with KaTeX math (see [Write Papers in Cortex](#write-papers-in-cortex) above)
295-
- **BibTeX citations**, figure/equation/table auto-numbering, cross-references
296-
- **Pandoc export** → PDF / LaTeX / DOCX / HTML
295+
Everything Claude touches live is visible: Edit, Write, Read, Grep, Glob, NotebookRead, NotebookEdit, and Bash paths inside commands — captured via the `PostToolUse` hook with compact markers so the graph rebuilds every ~2 minutes with fresh data.
297296

298297
<p align="center">
299-
<img src="docs/neural-graph-knowledge.png" width="100%" alt="Cortex Knowledge — card list of curated memories with emotion and consolidation colors" />
298+
<img src="docs/assets/cortex-consolidation-board.png" width="100%" alt="Cortex Board view — five columns for labile, early LTP, late LTP, consolidated, and reconsolidating memories, each column header showing total count and per-bucket stage metrics (decay, vulnerability, plasticity, heat, importance, encoding, interference, hippo, replay) plus cards grouped by stage" />
300299
</p>
301300

302-
**Knowledge View**curated memory cards with heat-based left border, emotion tag, consolidation stage, and evidence file references. Filter by domain or emotion; click any card for a full-screen detail panel with Markdown + JSON pretty-print.
301+
**Board View**consolidation stages as kanban columns (`labile` · `early_ltp` · `late_ltp` · `consolidated` · `reconsolidating`). Each column header reads live bucket metrics: **decay rate**, **vulnerability**, **plasticity**, **heat / importance / encoding / interference** medians, **hippocampal dependency**, and **replay count** — with the advancement rule (`replay ≥ 3`, `DA ≥ 1 or imp > 0.3`, etc.) printed under the bar. "At-risk" counter flags memories near promotion or decay. Cards inside each column carry heat, importance, surprise, valence, arousal, and the exact tool that created the memory.
303302

304303
<p align="center">
305-
<img src="docs/neural-graph-board.png" width="100%" alt="Cortex Board View — kanban columns for consolidation stages" />
304+
<img src="docs/assets/cortex-memory-detail.png" width="100%" alt="Cortex memory detail modal — stage pill, tags, valence chip, full body, then a Scientific measurements grid with plain-language explanations of consolidation stage, activity (heat), baseline activity, importance, surprise, emotional tone, emotional intensity, confidence, plasticity, stability" />
306305
</p>
307306

308-
**Board View**memories arranged across the four biological consolidation stages (`labile``early_ltp``late_ltp``consolidated`). Each card carries domain, heat, importance, and emotional tags so you can see what's hardening and what's still fragile.
307+
**Detail panelevery measurement explained.** Clicking a memory (or a file, skill, command, agent, hook, MCP, discussion) opens a modal with the raw value **and** a one-line plain-language explanation. Consolidation stage, activity (heat), baseline activity, importance, surprise, emotional tone, emotional intensity, confidence, plasticity, stability — each is a labeled bar with a sentence like *"How unexpected this memory was when it arrived. Surprises stick in the mind better than routine events."* No more staring at opaque numbers.
309308

310-
<p align="center">
311-
<img src="docs/neural-graph-pipeline.png" width="100%" alt="Cortex Pipeline View — Sankey flow through consolidation stages" />
312-
</p>
309+
**Knowledge View** — curated memory cards with heat-based left border, emotion tag, consolidation stage, and evidence file references. Filter by domain or emotion; click any card for a full-screen detail panel with Markdown + JSON pretty-print.
310+
311+
**Wiki View** — every memory admitted by the grounded-theory pipeline lands here as a structured page (ADR / spec / lesson / convention / note) with:
312+
313+
- EB Garamond body, IBM Plex Mono code, centered academic-paper layout
314+
- **Heat bar**, lifecycle pill (`active` / `area` / `archived` / `evergreen`), staleness flag, backlinks footer
315+
- **Inspector drawer** — full audit trail (memos, source claim events, draft history) for every page
316+
- **Inline CodeMirror 6 editor** + live preview with KaTeX math (see [Write Papers in Cortex](#write-papers-in-cortex) above)
317+
- **BibTeX citations**, figure/equation/table auto-numbering, cross-references
318+
- **Pandoc export** → PDF / LaTeX / DOCX / HTML
313319

314320
**Pipeline View** — horizontal Sankey flow from domains through the write gate into consolidation stages. Width of each ribbon = memory volume. Makes retention and drop-off across stages visible at a glance.
315321

785 KB
Loading
592 KB
Loading
3.04 MB
Loading

0 commit comments

Comments
 (0)