Use the ctxpin CLI to manage structured project notes in ContextPin workspaces. Never create notes manually — always use the CLI so IDs are generated correctly. Always use labels from .contextpin/settings.json (they support wildcards).
Use the ctxpin CLI to create, inspect, and manage structured notes in a ContextPin workspace.
ctxpin notes create note — it is the only way to get a valid ID (10-char nanoid). Manual creation risks missing IDs, duplicates, or malformed frontmatter..contextpin/settings.json. Labels support wildcard patterns (SPEC-*, *-DONE). Check the workspace settings before assigning labels.labels: array.# Create a note (generates valid ID, frontmatter, timestamps)
ctxpin notes create note "<Name>" [--folder "<Folder>"] [--json]
# Create a folder
ctxpin notes create folder "<Name>" [--parent "<Parent>"] [--json]
# List notes and folders (defaults to root)
ctxpin notes list [PATH] [--json]
# Show full info for a note or folder by ID
ctxpin notes show <ID> [--json]
# Resolve any ID or contextpin:// URI to its file path
ctxpin resolve <ID> [--json]
# Validate notes, detect issues (missing/duplicate IDs, broken refs)
ctxpin doctor [--json]
# Query the running ContextPin desktop app for active context
ctxpin ade show [--format claude|codex] [--json]
--workspace <PATH> # Override workspace root (skip auto-discovery)
-h, --help # Print help
# 1. Create the note via CLI
ctxpin notes create note "Architecture Overview" --folder "Specs" --json
# 2. The CLI outputs the file path and contextpin:// URI
# 3. Edit the created file to add content and labels
Notes are markdown files with YAML frontmatter (auto-generated by CLI):
---
schema_version: 1