kdex 0.0.4

kdex-0.0.4 is not a library.

The Problem

You have knowledge everywhere:

Code across dozens of repositories
Notes in Obsidian, Logseq, or markdown files
Docs scattered in wikis and READMEs

When you ask an AI assistant for help, it has no idea what's in YOUR files. You end up copy-pasting context manually.

The Solution

# Index everything
kdex index ~/code/my-project
kdex index ~/Documents/obsidian-vault
kdex index ~/wiki

# Search instantly
kdex search "how to deploy"

# AI assistants can now search your knowledge
kdex mcp  # Start MCP server for Copilot, Claude, Ollama

kdex creates a local search index that AI tools can query. Your data never leaves your machine.

✨ Features

Feature	Description
🔍 Instant Search	SQLite FTS5 gives sub-millisecond full-text search
🤖 AI-Ready	MCP server for GitHub Copilot, Claude, Ollama
📁 Universal	Code repos, Obsidian vaults, wikis, any markdown
🔒 Local-First	Your data stays on your machine. Always.
⚡ Fast	Index 100k files in seconds, search in milliseconds
🌐 Remote Repos	Add GitHub repos by URL—auto-cloned, auto-synced
📦 Portable	Export/import config for easy machine migration
🖥️ Interactive TUI	Full-screen interface with preview panel

🚀 Quickstart

# Install
cargo install kdex

# Index your project
kdex index .

# Add a GitHub repo
kdex add --remote owner/repo

# Search (just type your query!)
kdex "authentication"

# Launch interactive mode
kdex

That's it. Your knowledge, instantly searchable.

🤖 AI Integration

kdex speaks MCP (Model Context Protocol), so AI assistants can search your indexed content directly.

GitHub Copilot CLI

Add to ~/.config/github-copilot/mcp.json:

{
  "mcpServers": {
    "kdex": { "command": "kdex", "args": ["mcp"] }
  }
}

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kdex": { "command": "kdex", "args": ["mcp"] }
  }
}

Ollama (Local LLMs)

Pipe search results to your local model:

kdex search "error handling" --json | \
  jq -r '.results[].snippet' | \
  ollama run llama3 "Explain this code:"

See MCP Integration Guide for more details.

📖 What It Indexes

Source	Examples
Code Repositories	Any git repo, monorepos, microservices
Knowledge Bases	Obsidian vaults, Logseq graphs, Dendron
Documentation	Markdown wikis, READMEs, technical docs
Config Files	YAML, TOML, JSON with searchable content

kdex respects .gitignore and skips binary files automatically.

💻 Usage

Interactive Mode (TUI)

kdex

Full-screen interface with:

Real-time search as you type
File preview panel (Ctrl+P)
Repository management
Keyboard-driven navigation

Command Line

kdex index <path>              # Index a directory
kdex search <query>            # Search indexed content
kdex search <query> --json     # JSON output for scripting
kdex list                      # List indexed repositories
kdex remove <path>             # Remove from index
kdex mcp                       # Start MCP server

Run kdex --help for all options.

🔧 Installation

From crates.io (recommended)

cargo install kdex

From source

git clone https://github.com/urbanisierung/kdex.git
cd kdex
cargo install --path .

Requirements

Rust 1.88+ (install via rustup)
Works on Linux, macOS (Apple Silicon), and Windows

📚 Documentation

Features — Full feature list
Documentation — Detailed usage guide
MCP Integration — AI assistant setup
Ollama Integration — Local LLM workflow
Roadmap — What's coming next

🛠️ Development

make ci        # Run full CI pipeline (Docker)
make ci-quick  # Quick checks (format + clippy)
make test      # Run tests
make build     # Build debug binary

See CONTRIBUTING.md for development setup.