## 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

## Ready to organize your knowledge?

3 Crates | 56 Tests | 15K LOC | 100% Rust 🦀

Get Started →