Markdown is the source of truth
Every note is a plain .md file on your filesystem. No database lock-in, no proprietary format. Open them in any editor, version them with Git, sync them however you want.
Knowledge kernel
Your notes. Your filesystem. Your rules.
Codex is a local-first knowledge management app built in Rust. Markdown files, wikilinks, a knowledge graph, kanban boards, and an AI agent — all without a cloud account or subscription.
Designed for people who think in text files and want their tools to stay out of the way. Obsidian-compatible, Git-synced, cross-platform.
Markdown source of truth No account required Git sync built in
v0.3.0 Beta
macOS (notarized DMG) · iOS (TestFlight) · Linux amd64/aarch64 (CI builds)
Quick start
Clone the demo vault.
Download Codex, open it, and choose Clone remote vault. Enter the demo vault URL and you're in — documentation, examples, and a live knowledge graph.
git@github.com:styrene-lab/codex-demo-vault.git v0.3.0 · notarized · signed Getting started
~15 MBnotarized DMG
212tests passing
5platforms
0cloud dependencies
Why Codex
The tools should serve the thinking, not the other way around.
Local-first, sync-optional
Your vault works offline, always. Add Git sync when you're ready — Codex auto-commits and pushes in the background. iCloud sync also supported for zero-config setups.
Knowledge graph
Every wikilink creates an edge. The interactive force-directed graph shows how your ideas connect — filter by tags, zoom into neighborhoods, drag to rearrange.
Integrated AI agent
Omegon lives in the sidebar with full read/write access to your vault. Search, summarize, draft, manage tasks — all through natural conversation.
Kanban task boards
Built-in boards with decay-based relevance scoring. Tasks that go untouched naturally fade, surfacing what actually matters. Due dates, priorities, and agent integration.
Cross-platform
macOS desktop + iOS companion app from the same Rust codebase. Linux builds for amd64 and aarch64. One vault, every device.
What's included
Everything you need, nothing you don't.
Wikilinks & backlinks
Daily notes with templates
Excalidraw drawings
Query blocks (TABLE, LIST, TASK)
Live markdown preview
Command palette (Cmd+P)
Native macOS menus
Git-based multi-device sync
Publication system
TOML frontmatter
Obsidian vault compatible
Notarized macOS DMG
Ecosystem