Trusty Search

Website: trustytools.dev

Unified Rust workspace consolidating the entire trusty-* AI tooling ecosystem. 21 crates of AI development tooling with three flagship MCP servers for code search, memory management, and analysis.

Three Flagship MCP Servers

trusty-search — Hybrid Code Search

Machine-wide code search daemon with hybrid BM25 + vector + knowledge-graph fusion, fused via Reciprocal Rank Fusion. One install per machine, unlimited named project indexes.

What you get:

• Sub-10ms p50 warm query latency on 100k-chunk indexes
• Intelligent query routing (Definition / Usage / Conceptual / BugDebt intent detection)
• Knowledge graph expansion with caller/callee chains
• Branch-aware search (boost results from your current feature branch)
• Auto-tuned memory tiers (5 tiers from 8 GB to 64+ GB RAM)
• Embedded Svelte 5 admin UI
• OpenRouter-backed chat with auto-injected search context

Quick start:

cargo install trusty-search
trusty-search start
trusty-search index ~/Projects/myproj --name myproj
trusty-search query "fn authenticate" --index myproj

MCP tools: search, search_lexical, search_semantic, search_kg, search_all, search_similar, grep, typeahead, get_call_chain, index_file, remove_file, list_indexes, create_index, delete_index, reindex, index_status, list_chunks, search_health, chat, upgrade, console_metrics

See crates/trusty-search/README.md for full documentation.

---

trusty-memory — Memory Palace Storage Engine

Long-term memory storage with semantic search, persistent embedding index, and embedded Svelte UI. Store development context, notes, snippets, and retrieve them via natural language.

What you get:

• Pure-Rust HNSW vector index (hnsw_rs) persisted in redb + fastembed embeddings
• Semantic search over all stored memories
• Collection organization (notes, snippets, code patterns, decisions)
• Svelte UI for browsing and editing
• MCP server for Claude Code integration
• MIT license (memory preservation is for everyone)

Quick start:

cargo run -p trusty-memory -- serve
# Or via MCP stdio:
# Add to ~/.claude/claude_desktop_config.json:
# "trusty-memory": {
#   "command": "cargo",
#   "args": ["run", "-p", "trusty-memory", "--", "serve"]
# }

MCP tools: memory_remember, memory_recall, memory_recall_deep, memory_recall_all, memory_note, memory_list, memory_forget, list_prompt_facts, remove_prompt_fact, get_prompt_context

See crates/trusty-memory/README.md for full documentation.

---

trusty-analyze — Code Analysis Sidecar

Static code-analysis daemon (sidecar to trusty-search): cyclomatic and cognitive complexity, code smells, quality grading, git temporal decay, concept clustering, SCIP protobuf ingest, and a (subject, predicate, object) facts store backed by redb. Reads its chunk corpus from trusty-search over HTTP, then serves results on port 7879 via both an axum HTTP API and an MCP stdio/SSE server.

What you get:

• Cyclomatic + cognitive complexity per chunk / file / index
• Configurable code-smell categories with named thresholds
• A–F quality grade aggregation
• Git blame–driven temporal decay scoring (stale high-complexity code)
• k-means concept clustering (BoW or neural embeddings)
• Facts store: typed knowledge triples with provenance, persisted in redb
• SCIP protobuf ingest for LSP-quality symbol data
• Optional ONNX-backed NER over doc comments (feature-gated: --features ner)
• Tree-sitter adapters for Rust, TypeScript, JavaScript, Python, Java, Go, Ruby, PHP, C, C++, C#, Kotlin, Swift, Scala
• HTTP API + MCP parity (every endpoint has a tool equivalent)

Quick start:

# 1. trusty-search must be running first — it is a hard runtime dependency
cargo run -p trusty-search -- start

# 2. start the analyze sidecar
cargo run -p trusty-analyze -- serve --search-url http://127.0.0.1:7878

# 3. analyze a named index
cargo run -p trusty-analyze -- analyze <index-id> --top-k 20

MCP tools: analyzer_health, complexity_hotspots, find_smells, analyze_quality, list_facts, upsert_fact, delete_fact, ingest_scip, cluster_concepts

See crates/trusty-analyze/README.md for full documentation.

---

Full Crate Index (All 21 Crates)

Core Daemons / MCP Servers

Crate	Description	License
trusty-search	Hybrid code search (BM25 + vector + KG) + MCP server	MIT
trusty-memory	Memory palace UI + MCP frontend (storage engine lives in trusty-common's memory-core feature)	MIT
trusty-analyze	Code-analysis sidecar daemon (complexity, smells, facts) + MCP server	MIT

Shared Libraries

Crate	Description
trusty-common	Tracing, daemon helpers, OpenRouter chat client, shared utilities
trusty-embedderd	fastembed wrapper — all-MiniLM-L6-v2 INT8 quantised, 384-dim output
trusty-gworkspace	Google Workspace client (Calendar, Tasks, Drive)
trusty-cto-db	SQLite schema + rusqlite bindings for ops data
tc-services	Service adapters (CTO DB, Granola, GWorkspace)

MPM Platform (Multi-agent Platform Manager)

Crate	Description
trusty-mpm	Core platform with embedded CLI, daemon, and MCP server
trusty-mpm-gui	Desktop GUI (Tauri)

Supporting Tools & Agents

Crate	Description
trusty-code	Code generation and analysis utilities
trusty-console	Terminal UI for system monitoring
trusty-installer	Install/upgrade orchestrator (bins: trusty-installer, tctl alias; ADR-0013)
trusty-progress	Progress tracking and reporting
trusty-review	Code review automation and analysis

Analytics & Orchestration

Crate	Description
trusty-git-analytics	Developer productivity analytics from git history
trusty-agents	Agent orchestration platform
trusty-agents-common	Shared types and utilities for agent framework
trusty-agents-local	Local agent runtime implementation

Architecture

┌──────────────────────────────────────────────────────────────┐
│  Flagship Services (User-Facing)                             │
│  trusty-search  |  trusty-memory                             │
│  (search)       |  (storage)                                 │
└──────────────────────────────────────────────────────────────┘
         │                  │
┌────────▼──────────────────▼──────────────────────────────────┐
│  Storage / Engine Libraries                                 │
│  trusty-symgraph  ·  trusty-embedder  ·  trusty-cto-db      │
└────────┬──────────────────────────────────────────────────────┘
         │
┌────────▼──────────────────────────────────────────────────────┐
│  Shared Infrastructure                                       │
│  trusty-common  ·  trusty-mcp-core  ·  trusty-rpc           │
│  trusty-gworkspace  ·  trusty-tickets  ·  tc-services       │
└────────┬──────────────────────────────────────────────────────┘
         │
┌────────▼──────────────────────────────────────────────────────┐
│  Orchestrator / Platform                                    │
│  trusty-agents  ·  trusty-mpm-* family  ·  trusty-git-analytics  │
└───────────────────────────────────────────────────────────────┘

Getting Started

New to trusty-tools?

• Engineers: Start with Install and Run trusty-mpm (tm) on Your Laptop for the quickest path to a working session.
• Migrating from claude-mpm: Read claude-mpm vs trusty-mpm — Differences & Install to understand what changed and how to migrate.
• Developers: Consult Build & Test Commands below.

---

Installation

One-liner: curl | sh Bootstrap Installer

Install the full trusty-tools platform with one command (no Rust toolchain required):

curl -sSf https://raw.githubusercontent.com/bobmatnyc/trusty-tools/main/install.sh | sh

This downloads the prebuilt trusty-installer binary (SHA-256 verified), installs it to ~/.local/bin, and runs trusty-installer install to set up the rest of the platform (search, memory, analyze, review, console). The tctl transitional alias is also installed, so existing muscle-memory commands (tctl install, tctl status, etc.) continue to work.

Non-interactive (CI / scripted):

curl -sSf https://raw.githubusercontent.com/bobmatnyc/trusty-tools/main/install.sh | sh -s -- -y

Options (environment variables):

Variable	Effect
TRUSTY_VERSION	Pin a specific version (e.g. 0.2.0)
TRUSTY_INSTALL_DIR	Override the install directory (default ~/.local/bin)
TRUSTY_YES=1	Skip all prompts (same as -y)
TRUSTY_FORCE=1	Re-download even if already installed (same as --force)
TRUSTY_NO_MODIFY_PATH=1	Don't modify your shell PATH

Supported platforms: macOS (Apple Silicon) and Linux (x86_64). For other platforms, build from source with cargo install trusty-installer.

Security: The installer is served over HTTPS and every downloaded binary is SHA-256 verified against its published checksum. The installer script itself is not signed — review it before running if you require higher assurance: https://github.com/bobmatnyc/trusty-tools/blob/main/install.sh

---

With Homebrew

The easiest way to install individual trusty-* binaries via package manager. First, add the tap:

brew tap bobmatnyc/trusty

Then install any of the six published binaries:

brew install trusty-search
brew install trusty-memory
brew install trusty-analyze
brew install trusty-review
brew install trusty-mpm
brew install trusty-git-analytics

Or combine into a single command:

brew install bobmatnyc/trusty/trusty-search \
             bobmatnyc/trusty/trusty-memory \
             bobmatnyc/trusty/trusty-analyze \
             bobmatnyc/trusty/trusty-review \
             bobmatnyc/trusty/trusty-mpm \
             bobmatnyc/trusty/trusty-git-analytics

From Source with Cargo

If you prefer to build from the latest source or need a crate not distributed via Homebrew:

git clone https://github.com/bobmatnyc/trusty-tools
cd trusty-tools

# Build all crates
cargo build --release

# Run all tests
cargo test

# Install the CLI tools
cargo install --path crates/trusty-search --locked
# More tools available via: cargo install --path crates/<crate>

Build & Test Commands

cargo build                                          # all crates, debug
cargo build --release                               # all crates, release/optimized
cargo test                                          # all tests
cargo test -p <crate-name>                          # single crate tests
cargo check                                         # fast compile check
cargo clippy --workspace --all-targets -- -D warnings
cargo fmt --check
cargo fmt

Workspace Info

Single source of truth: Every crate is co-located under crates/ with one workspace root and one Cargo.lock, so a change spanning several of them is one commit.

MSRV: Rust 1.94+ (required by the aws-config / aws-sdk-bedrockruntime dependencies)

License: MIT for all crates. See each crate's Cargo.toml for the authoritative license field.

Where to start:

• I want to search code: Read crates/trusty-search/README.md
• I want persistent memory: Read crates/trusty-memory/README.md
• I want the full platform: Read crates/trusty-agents/README.md