Binder is a high-performance Go CLI tool, Agent Skill, and Model Context Protocol (MCP) server that converts plain markdown documentation into conformant Open Knowledge Format (OKF v0.2) knowledge bundles. Designed for deterministic CI/CD pipelines and agentic authoring workflows, it resolves wikilinks and relative links into graph edges, enriches metadata in place, extracts provenance and trust signals, and validates bundle integrity against strict specification conformance rules.
Key Features
- Deterministic Knowledge Ingestion: Walks arbitrary markdown repositories and generates clean, conformant OKF v0.2 bundles with byte-identical outputs across runs via
SOURCE_DATE_EPOCH. - Tri-Surface Architecture: Operates as a fast standalone Go CLI for automated pipelines, a Model Context Protocol (MCP) server for agent tool calls, and an Agent Skill/Plugin for interactive curation.
- Byte-Faithful Frontmatter Preservation: Preserves untouched YAML frontmatter verbatim (including exact key order and nested maps) on round-trip operations.
- In-Place Metadata Enrichment: Safely injects required catalog metadata into source repositories atomically without altering markdown body content.
- Multi-Format Graph & Analysis: Generates interactive graph visualizations (DOT, GraphML, JSON, HTML) and pre-flight lint reports with
--strictCI gating.
Built in Go with goldmark, Cobra, and the MCP Go SDK, Binder serves as the reference on-ramp and converter for the Open Knowledge Format ecosystem.