I built this because I kept hitting the same problem: AI tools are powerful but have no memory of my complex multi-repo project. They can't search our internal docs, past incidents, or architecture decisions. Cloud RAG services exist, but they're complex, expensive, and your data leaves your machine. I wanted something I could point at my sources and just run `ctx sync all`.

Quick start:

    # Install (pre-built binaries available for macOS/Linux/Windows)
    cargo install --git https://github.com/parallax-labs/context-harness.git

    # Create config and initialize
    ctx init

    # Sync your data sources (filesystem, Git, S3, or Lua scripts)
    ctx sync all

    # Search from CLI
    ctx search "how does the auth service validate tokens"

    # Or start the MCP server for Cursor/Claude Desktop
    ctx serve mcp

- *Truly local*: SQLite + single binary. No Docker, no Postgres, no cloud. Local embeddings (bundled or pure-Rust) so semantic and hybrid search work with zero API keys. Back up your entire knowledge base with `cp ctx.sqlite ctx.sqlite.bak`.

- *Hybrid search*: FTS5 keyword scoring + cosine vector similarity with configurable blending. Works without embeddings too (keyword-only mode); with local embeddings you get full hybrid search offline.

- *Lua extensibility*: Write custom connectors, tools, and agents in Lua without recompiling anything. The Lua VM has HTTP, JSON, crypto, and filesystem APIs built in.

- *Extension registry*: `ctx registry init` installs a Git-backed community registry with 10 connectors (Jira, Confluence, Slack, Notion, RSS, Stack Overflow, Linear, etc.), 4 MCP tools, and 2 agent personas.

- *MCP protocol*: Cursor, Claude Desktop, Continue.dev, and any MCP-compatible client can connect and search your knowledge base directly.

Embeddings: you can run *fully offline* — the default build uses local embeddings (fastembed with bundled ONNX on most platforms, or a pure-Rust tract path on Linux musl and Intel Mac). No API key required. Optional: Ollama (local LLM stack) or OpenAI if you prefer. Keyword-only mode needs zero deps. There's no built-in auth layer; it's designed for local or trusted network use.

Stack: Rust, SQLite (WAL mode), FTS5, mlua (Lua 5.4), axum, MCP Streamable HTTP. MIT licensed.

GitHub: https://github.com/parallax-labs/context-harness

Docs: https://parallax-labs.github.io/context-harness/

Community Registry: https://github.com/parallax-labs/ctx-registry

If you find it useful, a star on GitHub is always appreciated.

Would love feedback on the search quality tuning (hybrid alpha, candidate counts) and the Lua extension model.