Tools and implementations
Libraries, developer tools, and example applications built around the mdbase specification.
Implementation starter kit
The fastest route from a blank repository to a conforming adapter.
IMPLEMENTING.md
Walkthrough from zero to passing Level 1 conformance with concrete operation coverage.
- Conformance workflow
- Operation checklist
- Test YAML interpretation
REFERENCE-RUNNER.md
Reference adapter protocol for the shared conformance runner.
- stdin/stdout contract
- Assertions and setup format
- Command usage examples
adapter-template.py
Minimal shim to map runner operations into your implementation API.
- Dispatch skeleton
- Error mapping pattern
- Ready to extend per level
annotated-collection
Runnable collection fixture for manual behavior checks outside the test suite.
- Config + types + records
- Intentional invalid example
- Manual verification checklist
QUICK-REFERENCE.md
One-page summary for operations, types, errors, and expression operators.
- Fast day-to-day lookup
- Error code list
- Operator precedence
Core libraries
Reference-grade libraries for embedding mdbase behavior in applications and tools.
mdbase
Reference implementation of the mdbase specification. Provides collection loading, schema validation, querying, and expression evaluation.
- Full Level 6 conformance
- File watching and incremental updates
- Pluggable cache backends
mdbase-rs
High-performance Rust implementation for native tools and CLI applications where speed is critical.
- Zero-copy YAML parsing
- Parallel collection loading
- C FFI bindings
Build and edit
Tools that make the specification usable from terminals, editors, and repo workflows.
mdbase-cli
Command-line interface for working with mdbase collections. Query, validate, and manage collections from the terminal.
- Interactive query REPL
- Schema validation and linting
- Record creation scaffolding
mdbase-lsp
Language Server Protocol implementation with diagnostics, completions, and hover information in editors.
- Real-time validation diagnostics
- Frontmatter field completion
- Link target resolution and go-to-definition
mdbase-tasknotes
Standalone task management CLI that operates directly on Markdown files via mdbase.
- Natural language task creation
- Timer, project, and statistics commands
- Compatible with TaskNotes plugin vaults
ops
Markdown-native operations CLI for AI-assisted GitHub workflows using typed mdbase sidecars.
- Typed `.ops/` sidecars committed with code
- Reusable command templates with variable expansion
- Built-in triage, review, and handoff flows
Agent tooling
Structured collection access for coding assistants and local agent workflows.
mdbase-skill
Agent skill that gives AI coding assistants structured access to mdbase collections for reading, querying, and editing records.
- Collection-aware context for AI agents
- Schema-guided record creation
- Natural language to mdbase query translation
Example applications
Small products that make the spec concrete in real domains.
mdbase-workouts
Full-stack workout tracker built on mdbase collections. Demonstrates type definitions, linked records, computed fields, and querying in a real application.
- Exercise and workout log types with links
- Query-driven dashboards and history views
- Progressive web app with offline support