Welcome to Codex

Codex is a local-first knowledge management app built in Rust. Your notes are plain markdown files that live on your filesystem. No cloud account required, no vendor lock-in, no subscription.

What makes Codex different

• Markdown is the source of truth. Every note is a .md file. Open them in any editor, sync them with any tool, version them with Git.
• Local-first, sync-optional. Your vault works offline. Add Git sync when you're ready — Codex auto-commits and pushes in the background.
• Integrated AI agent. Omegon lives in the sidebar. Ask it about your notes, have it draft content, or let it manage tasks.
• Cross-platform. macOS desktop + iOS companion app from the same Rust codebase.

Quick start

1. You're already in the vault. Browse the sidebar to explore.
2. Press Cmd+N to create a new note.
3. Press Cmd+D for today's daily note.
4. Press Cmd+P to open the command palette.
5. Press Cmd+Shift+D to create a drawing.

Explore

• Getting Started — first steps after install
• Keyboard Shortcuts — everything you can do from the keyboard
• Wikilinks and Backlinks — how notes connect to each other
• Daily Notes — journaling and daily workflow
• Query Blocks — Dataview-style inline queries
• Excalidraw Drawings — visual thinking with embedded diagrams
• Git Sync — keeping devices in sync
• Omegon Agent — your AI assistant
• Kanban Boards — task management with boards
• Graph View — visualizing your knowledge

About this vault

This is the official demo vault for Codex. It's also the source for the Codex documentation site. Every note marked with [publication] enabled = true is published automatically.