@@ -34,7 +34,47 @@ returns source citations—or explicitly abstains when the evidence is not there
3434> follow the beta** . If something breaks, tell us—the project is built in the
3535> open and the rough edges are documented.
3636
37- ## Why Cortex exists
37+ ## What Cortex does today
38+
39+ Cortex is a ** macOS beta** . It runs a local engine on your Mac that ingests your notes and AI-chat
40+ exports, turns them into typed and cited memory you review, and serves that memory to AI tools over
41+ MCP.
42+
43+ Concretely, today you can:
44+
45+ - ** Bring in your history.** Drop in a ChatGPT, Claude, Gemini, Notion, Slack, Discord, or Telegram
46+ export — or mbox/eml, ` .ics ` , ` .vcf ` , DOCX, Zoom transcripts, browser bookmarks, an X or LinkedIn
47+ archive, and more. See [ ` docs/SOURCE_IMPORTS.md ` ] ( docs/SOURCE_IMPORTS.md ) .
48+ - ** Sync live sources with a key you paste.** GitHub (secretless device-flow sign-in), Slack, Linear,
49+ Jira, Readwise, Raindrop, Zotero, Calendar, Notion, and Obsidian.
50+ - ** Review before you remember.** Captures from connected sources land in a Review inbox, grouped into at
51+ most fifteen decisions, where you approve, edit, or archive. Approving records the memory and its audit
52+ event in SQLite, then mirrors it to your Markdown vault. Files you import yourself are treated as trusted
53+ and are usable right away; pass ` auto_approve=false ` to route them through Review too.
54+ - ** Ask and get citations or nothing.** Retrieval fuses BM25, ` sqlite-vec ` vector KNN, and temporal
55+ signals, reranks on-device, and passes through a cite-or-abstain gate. With no cited evidence it tells
56+ you so rather than guessing.
57+ - ** Connect your tools in one click.** Claude Desktop, Cursor, Windsurf, Zed, Cline, Roo Code, VS Code
58+ Copilot, and Claude Code get a Cortex MCP server written into their config.
59+ - ** Keep control.** Per-tool tokens are scoped and revocable, secret/email redaction is on by default,
60+ and export, maintenance, and destructive capabilities are ** off** until you enable them.
61+
62+ Ask composes its answers deterministically from cited excerpts — no generative language model is
63+ bundled or called to write prose. Retrieval embeddings run entirely on-device.
64+
65+ ### Current limitations, plainly
66+
67+ - ** Apple Silicon, macOS 13+.** The Swift target is ` arm64-apple-macosx13.0 ` ; there is no Intel or
68+ universal build.
69+ - ** This beta requires a one-time account sign-in.** The shipped build sets ` CortexRequireAccount ` , so
70+ first launch shows a sign-in wall. Your memory still lives and is queried locally — the account is
71+ identity plus an optional sync target. There is an "Explore with sample notes" path, but it is not
72+ remembered between launches.
73+ - ** Cloud sync is not end-to-end encrypted by default.** Client-side E2EE exists but is opt-in and off,
74+ so anything you sync is readable server-side. See [ ` docs/E2EE_SYNC_DESIGN.md ` ] ( docs/E2EE_SYNC_DESIGN.md ) .
75+ - ** Managed Google / Microsoft / Notion OAuth is implemented but not configured** in this build; those
76+ client IDs ship empty. Use file import or a pasted token instead.
77+ - ** PDF text extraction is inactive** in the shipped app — ` pypdf ` is not bundled.
3878
3979| Stop repeating yourself | Keep memory trustworthy | Switch tools freely | Inspect everything |
4080| ---| ---| ---| ---|
@@ -412,7 +452,7 @@ file and focused test for a change.
412452| Sync & encryption | [ ` docs/E2EE_SYNC_DESIGN.md ` ] ( docs/E2EE_SYNC_DESIGN.md ) · [ ` docs/CXE1_WIRE_FORMAT.md ` ] ( docs/CXE1_WIRE_FORMAT.md ) |
413453| Install & update checks | [ ` docs/INSTALLER_AND_UPDATES.md ` ] ( docs/INSTALLER_AND_UPDATES.md ) |
414454| Release & distribution | [ ` docs/DISTRIBUTION.md ` ] ( docs/DISTRIBUTION.md ) · [ ` docs/APPLE_RELEASE.md ` ] ( docs/APPLE_RELEASE.md ) |
415- | Experimental pairwise twin evaluation | [ Overview ] ( https://github.com/trace-cortex/cortex-app/blob/feat/pairwise-twin-eval/ docs/PAIRWISE_TWIN_EVALUATION.md) · [ Integration guide ] ( https://github.com/trace-cortex/cortex-app/blob/feat/pairwise-twin-eval/ docs/PAIRWISE_TWIN_INTEGRATION_GUIDE.md) |
455+ | Experimental pairwise twin evaluation | [ ` docs/PAIRWISE_TWIN_EVALUATION.md ` ] ( docs/PAIRWISE_TWIN_EVALUATION.md ) · [ ` docs/PAIRWISE_TWIN_INTEGRATION_GUIDE.md ` ] ( docs/PAIRWISE_TWIN_INTEGRATION_GUIDE.md ) |
416456
417457## Build with us
418458
0 commit comments