Reference
Celorga reference is split into two detailed sections:
-
installed capability discovery
cited retrieval commands and safe write contract
-
stdio server setup for common clients
current resources, prompts, typed tools, and corpus boundaries
portable general skill installation and CLI fallback
-
every core syntax construct
TODO/priority/tags/drawers/planning/timestamps
links, lists, blocks, tables, directives, comments
-
canonical
raw/->notes/->compiled/->views/->publish/zonesartifact roles, provenance, and generated-output boundaries
-
Shared corpora and collaboration
portable corpus identity and local mounts
corpus-qualified federated agenda/search, active-corpus write boundaries, and the incremental team path
-
agenda filters and views
formatter behavior
content-addressed Git plugins, trust, commands, templates, and document renderers
roam workflows (IDs/backlinks/node creation/link insertion)
export/publish/LSP workflows
-
macOS Workspace app
VS Code installation
complete default keyboard shortcut map
Vim/Neovim filetype support and Emacs coexistence notes
-
Maintenance and health workflows
compiler-style lint, health, and repair passes
trust boundaries for generated artifacts
-
what is normative now
what is stable but still implementation-defined
what is roadmap
-
using existing
.orgfilesmixing ID links and title links
For the independently implementable language standard, see SPEC.org, GRAMMAR.ebnf, and PARSING.org.
Live embed resolution
celorga embed resolve --target TARGET --file SOURCE [--dir CORPUS] [--json] is read-only. It returns org2:embed-resolution:v1 JSON containing a portable directive, title, resolved file, and source line, without copying source content. Targets are explicit id:STABLE-ID note/heading references or file:relative/path.org whole-note references; .org2 remains supported. Relative paths resolve from SOURCE. When --dir is omitted, the nearest org2.json defines the corpus, falling back to the source directory.
The shared app renderer interprets #+EMBED: TARGET keyword lines using compiled corpus IDs and source ranges. It rejects ambiguous IDs and out-of-corpus files, bounds cycles/depth/content, and renders source navigation beside read-only inline content. Ordinary HTML exports preserve references without resolving them; disclosure-safe publish document strips targets and emits an omission marker. See Live note and heading embeds for insertion, refresh, and limits.