Git-Native Knowledge Management
Knowledge Graphs
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
01
Scattered Documentation
- Notes in Notion
- Decisions in Slack
- Guidelines in wikis—all disconnected
- KOGRAL unifies with git-native markdown + MCP
02
No Version Control for Decisions
- Architectural decisions lost in chat history
- No traceability for why code exists
- KOGRAL: Git-tracked ADRs with full history
- Link decisions directly to code with @file:line
03
Lost Context Over Time
- Team members join and can't find past decisions
- Outdated documentation causes repeated mistakes
- KOGRAL: Semantic search across your knowledge base
- Relationship tracking shows why patterns exist
04
Isolated Team Knowledge
- Every project reinvents the wheel
- Patterns can't be shared across teams
- KOGRAL: Multi-graph architecture
- Shared organizational knowledge + project-specific overrides
- Inheritance system for guidelines
How It Works
Markdown-Native
- YAML frontmatter for metadata
- Wikilinks [[like-this]] 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
- Local embeddings (fastembed, no API costs)
- Cloud APIs supported (OpenAI, Claude, Ollama)
- Find related knowledge automatically
Config-Driven
- Nickel schemas with validation
- 3 modes: dev, prod, test
- Storage backend selection (filesystem, SurrealDB, in-memory)
- Embedding provider configuration
- No hardcoded paths or settings
Claude Code Integration
- MCP server (Model Context Protocol)
- 7 tools: search, add notes/decisions, link, export
- 6 resources: project/shared graphs
- 2 prompts: summarize project, find related
- JSON-RPC 2.0 over stdio
Technology Stack
Rust Edition 2021
Nickel Config
SurrealDB
fastembed
rig-core
MCP Protocol
Logseq Compatible
Tera Templates
Clap CLI
DashMap
Nushell Scripts
mdBook Docs
Core Components
kogral-coreCore library
kogral-cli13 commands
kogral-mcpMCP server
Config SystemNickel schemas
3 Storage BackendsFilesystem, SurrealDB, Memory
2 Embedding ProvidersFastEmbed, rig-core
6 Node TypesNote, Decision, Guideline, Pattern, Journal, Execution
6 Relationshipsrelates_to, depends_on, implements, extends, supersedes, explains
Multi-GraphProject + Shared
56 Tests PassingQuality assurance
0 Unsafe CodeMemory safety
100% Doc CoveragePublic APIs documented