tags	category	created	updated	related
documentation overview vault-structure	patterns	2026-05-23	2026-08-01	AGENTS.md index.md

Context Vault

A self-hosted knowledge base for AI learning, patterns, and conversation summaries. Synced across devices via Git.

Structure

context-vault/
├── projects/           # Project-specific learnings and decisions
├── patterns/           # Reusable code patterns and solutions
├── conversations/      # Session summaries and context snapshots
├── scripts/            # Query and search utilities
└── index.md            # Tag and category registry

File Format

All notes use YAML frontmatter for queryable metadata:

---
tags: [example, keywords, tags]
project: project-name
category: architecture|patterns|errors|learnings
created: 2026-05-23
updated: 2026-05-23
related: [other-file.md]
---

# Note Title

Content in markdown format...

Query Tools

Search by tag

./scripts/query-by-tag.sh typescript

Search by project

./scripts/query-by-project.sh project-name

Full-text search

./scripts/search.sh "search term"

Auto-Save Format

After conversations, notes are automatically saved with:

• Timestamp-based filename: conversations/2026-05-23-project-summary.md
• YAML metadata: tags, project, category
• Content:
  • Code patterns discovered
  • Errors + solutions
  • Architecture decisions
  • File references with line numbers (format: path/file.ts:123)
  • Related learnings

Quick Start

1. Clone/pull this repo to sync
2. Run just fmt to format repository files
3. Use query tools to find context
4. Review and commit changes locally
5. Push to main branch

Formatting

Run the pinned treefmt-nix configuration through just:

just fmt

This runs nix fmt with formatters for Nix, Markdown, justfiles, and shell scripts. YAML frontmatter is preserved with the mdformat-frontmatter plugin.