Glossary
- Plaintext Tasks
- A strict plain-text task format with headings, checklist states, notes, metadata lines, indentation-based subtasks, and an optional archive region. See Plaintext Tasks for the current spec and version history.
- plaintext files
- Human-readable documents in Markdown or .txt.
- Corpus
- A folder of open files (your knowledge base/archive) that serves as the system of record.
- frontmatter
- Lightweight metadata at the top of a Markdown file (e.g., YAML).
- sidecar / metadata file
- A tiny
.json/.yaml file placed next to a .txt note when metadata is needed. - tools
- Editors, CLIs, indexers, and agents that operate on the corpus without owning it.
- previewable writes
- A workflow where tools generate human-auditable change previews before applying writes.
- provenance trail
- A simple history/log explaining why changes were applied, not only what changed.
- AI / agent-aware
- A tool exposing open, automatable interfaces (e.g., CLI, MCP, stdio, HTTP) for safe scripted/agent use.
- browsing & searching
- Exploration and retrieval through indexers, embeddings, and link graphs.
