Welcome: What Is ONDE?

One-Line Pitch

onde turn plain markdown into typed, temporal, queryable graph. One command. Zero daemon.

Core Promise

Journal = truth. Append-only CRDT log. Eternal. Git-mergeable. Never deleted.
Markdown = view. Materialized cache. Delete anytime. onde materialize rebuild.
Terminal = UI. Pipe-native. CLI-first. No GUI lock-in.
Agent = first-class. Exact graph math. Temporal memory. Token-optimized. LLM consume raw MD. onde lint sync.

Who It’s For

Human: Want structure without plugin hell. Write freely. Add schema when chaos loom.
Team: Want Git-native collaboration. Concurrent edit. Zero merge conflict. CRDT heal.
Agent/LLM: Need exact truth over fuzzy vector search. Typed edge. Point-in-time query. Deterministic output.

What You Get

onde lint = heartbeat. Parse → diff → journal → auto-fix → validate → materialize.
Auto-bookkeeping: ID, count, defaults, inverse, link resolve, timestamp. Agent write content. onde handle math.
Temporal core: Every fact carry created_at + invalidated_at. Query past graph like it still here.
TOON density: Pipe-delimited outline. ~15 tokens/node. Pack 10x more context per window.
Schema evolution: Start loose. Extract law. Tighten when ready. Zero migration pain.
Git-native: ops.md append-only. Merge = line add. onde git commit auto-message.

What You Don’t Get

Cloud sync. (Use Git.)
WYSIWYG editor. (Use VS Code, Obsidian, Neovim, any MD editor.)
Hidden binary database. (Data live in plain text + append-only journal.)
Always-on daemon/watcher. (Sync on demand. --watch optional.)
Vendor lock-in. (Exit anytime. Delete .onde/. Keep markdown.)

Why It’s Different

Traditional Tool	`onde`
DB hide data in binary blob	Disk = database. Markdown = UI.
Plugin manage structure	Structure embed in text. Schema opt-in.
Sync always-on, conflict-prone	Sync on `onde lint`. CRDT merge. Zero conflict.
Vector search = fuzzy vibes	Typed edge + temporal index = exact truth.
Agent guess from context window	Agent pipe exact graph. Deterministic.

How to Read This Guide

New to onde? → Section 1. Mental model + 10-min hands-on.
From Obsidian/Roam/Logseq? → Section 1. We translate your workflow.
Building agent/LLM pipeline? → Section 10. CLI pipes, SKILL.md, memory replacement.
Need command fast? → Section 11. Cheat sheet, exit codes, fix paths.
Rule: Human first. Terminal second. Agent last. Progressive disclosure. Zero theory without command.

Next Step: → Mental Model: How onde Maps to Tools You Know