Local-First Knowledge Management
v0.1.0 | Foundation Complete | 97+ testsKnowledge Graphs For Developer Teams
Structured knowledge management that scales from solo projects to organizations. Config-driven architecture for capturing architectural decisions, coding guidelines, and reusable patterns in version-controlled markdown. 100% Rust. Zero compromises.
The 4 Problems It Solves
Scattered Documentation
Notes in Notion, decisions in Slack, guidelines in wikis — all disconnected. KOGRAL unifies with git-native markdown + MCP.
No Version Control for Decisions
Architectural decisions lost in chat history. No traceability for why code exists. KOGRAL provides Git-tracked ADRs with full history and @file:line code references.
Lost Context Over Time
New team members can't find past decisions. Outdated documentation causes repeated mistakes. KOGRAL offers semantic search and relationship tracking.
Isolated Team Knowledge
Every project reinvents the wheel. Patterns can't be shared across teams. KOGRAL's multi-graph architecture enables shared organizational knowledge with project-specific overrides.
How It Works
Markdown-Native
YAML frontmatter for metadata. Wikilinks for relationships. Code references @file.rs:42. Logseq-compatible format. Human-readable, Git-friendly.
Semantic Search
Text search across all nodes. Vector embeddings for semantic queries via stratum-embeddings with local fastembed. Cloud APIs supported (OpenAI, Claude, Ollama via rig-core).
Config-Driven
Nickel schemas with validation. 3 modes: dev, prod, test. Storage Factory with config-driven backend dispatch. TypeDialog fragment composition pattern. No hardcoded paths or settings.
Claude Code Integration
MCP server (Model Context Protocol). 10 tools in kogral/* namespace (search, blocks, todos, cards). 6 resources via kogral:// URI scheme. 2 prompts for project summarization and related content discovery.
Logseq Blocks
Outliner-style hierarchical blocks. Task status: TODO, DOING, DONE, LATER, WAITING. Inline #tags and custom properties. Block references and page refs. Round-trip fidelity for Logseq import/export.
Event System & Orchestration
NATS JetStream event publishing. EventingStorage decorator wraps any backend. KogralEvent types for node and graph operations. stratum-orchestrator pipeline triggering. SurrealDB dual-engine support.