Add Documents

Create a document


ctx add nodes/api-design --title "API Design Guide" --tags "engineering,api"

This creates nodes/api-design.md with frontmatter, publishes it (bumps version, creates a checkpoint), and regenerates the index.

Document format

Every Context Nest document is a Markdown file with YAML frontmatter:


---
title: "API Design Guide"
type: document
tags: ["#engineering", "#api"]
status: published
version: 1
created_at: "2026-03-15T12:00:00Z"
---
 
# API Design Guide
 
Your content here. Plain Markdown with GFM support.
 
## Context Links
 
Reference other documents: [Architecture](contextnest://nodes/architecture-overview)

Update a document


ctx update nodes/api-design --title "API Design Standards" --body "Updated content here"

Updates auto-publish: the version is bumped, a new checkpoint is created, and the index is regenerated.

Delete a document


ctx delete nodes/api-design

List documents


ctx list                          # All documents
ctx list --type reference         # Filter by type
ctx list --status published       # Filter by status
ctx list --tag engineering        # Filter by tag
ctx list --json                   # JSON output