Skip to content

Commit e2095b1

Browse files
committed
docs: reposition Cortex as a scientific-authoring tool, not just memory+graph
The current README positions Cortex as memory + neural graph. After Phase 2-10 of the wiki redesign, it's also a first-class scientific authoring environment — CodeMirror editor, KaTeX math, BibTeX citations, Pandoc export — and readers weren't picking that up. Two changes: 1. New "Write papers in Cortex" section near the top of the README (right after Getting Started), with the edit-mode split-pane screenshot as the headline visual. Enumerates the authoring capabilities in scannable form. 2. Enhanced "Wiki View" subsection in the Views section — bulleted feature list (heat bar, lifecycle pill, inspector, editor, citations, export) that mirrors the top-section narrative and links back to it. TOC updated with the new anchor.
1 parent c1a4271 commit e2095b1

3 files changed

Lines changed: 27 additions & 2 deletions

File tree

README.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
</p>
1212

1313
<p align="center">
14-
<a href="#getting-started">Getting Started</a> · <a href="#what-this-actually-feels-like">What It Feels Like</a> · <a href="#retrieval-that-actually-works">Benchmarks</a> · <a href="#the-science-under-the-hood">Science</a> · <a href="#neural-graph">Views</a>
14+
<a href="#getting-started">Getting Started</a> · <a href="#write-papers-in-cortex">Write Papers</a> · <a href="#what-this-actually-feels-like">What It Feels Like</a> · <a href="#retrieval-that-actually-works">Benchmarks</a> · <a href="#the-science-under-the-hood">Science</a> · <a href="#neural-graph">Views</a>
1515
</p>
1616

1717
<p align="center">
@@ -78,6 +78,24 @@ docker run -it \
7878

7979
---
8080

81+
## Write papers in Cortex
82+
83+
Cortex doesn't just remember — it authors. Every memory that passes the pipeline becomes a structured wiki page, editable in place with a full scientific writing environment:
84+
85+
<p align="center">
86+
<img src="docs/wiki-edit.png" width="100%" alt="Cortex Wiki editor — CodeMirror 6 source pane on the left, live-preview pane on the right with headings, lists, and structured sections rendered via the project's LaTeX-inspired typography" />
87+
</p>
88+
89+
- **CodeMirror 6 inline editor** with live preview; save round-trips atomically to the `.md` file on disk (git-diffable).
90+
- **LaTeX math**`$E=\nabla \cdot F$` and `$$…$$` blocks rendered live via KaTeX.
91+
- **BibTeX citations** — drop `.bib` files under `wiki/_bibliography/`, use `[@friston2010]` inline, and Citation.js resolves them to `(Friston 2010)` with an auto-generated APA bibliography.
92+
- **Figure / equation / table auto-numbering**`{#fig:arch}` labels, `{@fig:arch}` cross-refs, resolved to `Figure 1` / `Equation 3` / `Section 2.1`.
93+
- **Pandoc export** — one click produces PDF (via LaTeX), TEX, DOCX, or HTML. Journal-submittable from the same markdown that feeds the memory pipeline.
94+
95+
The source stays markdown. Your `.md` files remain grep-able, diffable, and interoperable with any external tool. Cortex adds a rendering + editing + export layer on top without stealing your content into a proprietary format.
96+
97+
---
98+
8199
## What this actually feels like
82100

83101
**Monday.** You spend an hour debugging a webhook handler. After tracing through four layers, you find the root cause: a race condition in the Redis session store where TTL expiry can fire between the auth check and the permission lookup. You discuss the fix with Claude, decide on an approach, and implement it. Session ends.
@@ -256,7 +274,14 @@ Launch with `/cortex-visualize`. Five views wired over the same data:
256274
<img src="docs/neural-graph-wiki.png" width="100%" alt="Cortex Wiki — LaTeX-styled page with thermodynamic heat bar, lifecycle pill, backlinks, and inspector drawer" />
257275
</p>
258276

259-
**Wiki View** — every memory admitted by the grounded-theory pipeline lands here as a structured page (ADR, spec, lesson, convention, note). EB Garamond body, IBM Plex Mono code, heat bar, lifecycle pill (`active` / `area` / `archived` / `evergreen`), staleness flag, backlinks footer, and an inspector drawer exposing the full audit trail (memos, source claim events, draft history).
277+
**Wiki View** — every memory admitted by the grounded-theory pipeline lands here as a structured page (ADR / spec / lesson / convention / note) with:
278+
279+
- EB Garamond body, IBM Plex Mono code, centered academic-paper layout
280+
- **Heat bar**, lifecycle pill (`active` / `area` / `archived` / `evergreen`), staleness flag, backlinks footer
281+
- **Inspector drawer** — full audit trail (memos, source claim events, draft history) for every page
282+
- **Inline CodeMirror 6 editor** + live preview with KaTeX math (see [Write Papers in Cortex](#write-papers-in-cortex) above)
283+
- **BibTeX citations**, figure/equation/table auto-numbering, cross-references
284+
- **Pandoc export** → PDF / LaTeX / DOCX / HTML
260285

261286
<p align="center">
262287
<img src="docs/neural-graph-knowledge.png" width="100%" alt="Cortex Knowledge — card list of curated memories with emotion and consolidation colors" />

docs/wiki-edit.png

707 KB
Loading

docs/wiki-paper.png

503 KB
Loading

0 commit comments

Comments
 (0)