Ecosystem

Tools and implementations

Libraries, developer tools, and example applications built around the mdbase specification.

Implementations

Core libraries

TypeScript

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
callumalpass/mdbase
Rust

mdbase-rs

High-performance Rust implementation. Designed for embedding in native tools and CLI applications where speed is critical.

  • Zero-copy YAML parsing
  • Parallel collection loading
  • C FFI bindings
callumalpass/mdbase-rs
Developer Tools

Build and edit

CLI

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
callumalpass/mdbase-cli
LSP

mdbase-lsp

Language Server Protocol implementation for mdbase collections. Provides diagnostics, completions, and hover information in your editor.

  • Real-time validation diagnostics
  • Frontmatter field completion
  • Link target resolution and go-to-definition
callumalpass/mdbase-lsp
CLI

mdbase-tasknotes

Standalone task management CLI that operates directly on markdown files via mdbase. Natural language input, time tracking, and project aggregation without requiring Obsidian.

  • Natural language task creation
  • Timer, project, and statistics commands
  • Compatible with TaskNotes plugin vaults
callumalpass/mdbase-tasknotes
CLI

ops

Markdown-native operations CLI for AI-assisted GitHub workflows. Uses typed mdbase sidecars to track triage decisions, status, and handoffs directly in your repo.

  • Typed `.ops/` sidecars committed with code
  • Reusable command templates with variable expansion
  • Built-in triage, review, and handoff flows
callumalpass/ops
AI Integration

Agent tooling

Skill

mdbase-skill

Agent skill for AI coding assistants. Gives Claude Code and other AI tools 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
callumalpass/mdbase-skill
Examples

Example applications

App

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
callumalpass/mdbase-workouts