Compatibility: Git, Obsidian & AI Agents
Context Nest is designed to work with existing tools and workflows.
Git
Context Nest vaults are git-friendly by design. All files are plain text (Markdown, YAML).
Recommended .gitignore:
.context/welcome.html
Version history (.versions/) should be committed — it's part of the vault's integrity chain.
Obsidian
Context Nest supports an Obsidian-compatible layout mode:
ctx init --layout obsidian
In Obsidian mode:
- Documents live at the vault root (no
nodes/directory) - The
sourcefrontmatter block appears in Obsidian's Properties panel - Source node bodies are readable as regular markdown runbooks
- Context links use
contextnest://URIs which Obsidian will display as plain links
AI agents
Context Nest is agent-agnostic. It works with any tool that can read Markdown files or connect via MCP:
| Tool | Integration |
|---|---|
| Claude (Code, Desktop) | MCP server, direct file access |
| Cursor | MCP server, direct file access |
| VS Code + Copilot | MCP server |
| ChatGPT | MCP server |
| Custom agents | CLI (ctx query), MCP server, or direct file reads |
File format
The Context Nest format is intentionally simple:
- Plain Markdown with YAML frontmatter (GFM compatible)
- YAML configuration files
- No binary formats, no databases, no proprietary encoding
- Any tool that reads Markdown can read a Context Nest vault
Related pages
- PromptOwl DocumentationWelcome to the documentation for PromptOwl and Context Nest — the open protocol and hosted platform for giving AI agents structured, versioned, governed…
- Add DocumentsThis creates nodes/api-design.md from a frontmatter template as version 1, and regenerates the index. Tags accept a comma- or space-separated list; you…
- Addressing OverviewContext Nest uses the contextnest:// URI scheme to address documents, sections, tags, and folders within a vault.
- Authentication & API KeysContextNest Community distinguishes two kinds of key, and it is worth keeping them straight:
- CLI ReferenceThe Context Nest CLI (ctx) is a structured, versioned knowledge base your AI agents can query. It provides commands for setting up vaults, creating and…