Rust workspace · MIT

Tooling for AI-assisted development, in one workspace.

trusty-tools is one Cargo workspace for the trusty-* ecosystem: hybrid code search, a memory palace, and a code-analysis sidecar, each with an MCP server.

Install View on GitHub

License: MIT
MSRV: Rust 1.94
Prebuilt for: macOS arm64, Linux x86_64, Linux arm64

What trusty-tools is

A single Cargo workspace holding the whole trusty-* family — shared libraries, daemons and MCP servers, a multi-agent platform, and an orchestrator. It replaces seven formerly separate repositories, so cross-crate changes are one atomic commit instead of a chain of version bumps and patch tables.

Each crate versions, tags, and publishes independently, and everything is MIT licensed. The three flagship services below each speak the Model Context Protocol, so they plug into Claude Code and any other MCP client without a bespoke integration.

Three flagship MCP servers

UNIT 01

trusty-search

Hybrid code search

BM25, vector, and knowledge-graph retrieval fused with Reciprocal Rank Fusion
One machine-wide daemon, unlimited named project indexes
Query-intent routing across definition, usage, conceptual, and bug/debt lookups
Branch-aware ranking and caller/callee chain expansion

UNIT 02

trusty-memory

Memory palace storage

HNSW vector index over SQLite, embedded with fastembed
Semantic recall across everything you have stored
Collections for notes, snippets, code patterns, and decisions
Svelte UI for browsing and editing, plus an MCP server

UNIT 03

trusty-analyze

Code analysis sidecar

Cyclomatic and cognitive complexity per chunk, file, and index
Configurable code-smell categories and A–F quality grading
Git-blame temporal decay to surface stale, complex code
Tree-sitter adapters for 14 languages; HTTP and MCP parity

The crate lineup

A selection of what lives under crates/. The workspace glob in the root Cargo.toml is the authoritative list.

Daemons & MCP servers

trusty-search

Hybrid code search (BM25 + vector + KG)
trusty-memory

Memory palace UI and MCP frontend
trusty-analyze

Complexity, smells, and a facts store
trusty-bm25-daemon

Standalone BM25 full-text search daemon

Shared libraries

trusty-common

Tracing, daemon helpers, shared utilities
trusty-embedderd

fastembed wrapper, 384-dimension output
trusty-gworkspace

Google Workspace client
trusty-cto-db

SQLite schema and rusqlite bindings

Platform & agents

trusty-mpm

Multi-agent platform: CLI, daemon, MCP server
trusty-mpm-gui

Desktop GUI, built with Tauri
trusty-agents

Agent orchestration platform
trusty-installer

Install and upgrade orchestrator (tctl)

Tools & analytics

trusty-review

Code review automation and analysis
trusty-git-analytics

Developer analytics from git history
trusty-console

Terminal UI for system monitoring
trusty-code

Code generation and analysis utilities

Install

A bare tctl install brings up the seven managed crates in dependency order. Name one to install just that crate and whatever it needs at runtime.

Bootstrap, then tctl

Recommended. No Rust toolchain needed on a supported platform. Resolves the runtime dependency graph, and keeps macOS signing grants stable across upgrades.

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

Homebrew

Ten formulae in the tap. Installs one binary, without the dependency resolution tctl does.

brew tap bobmatnyc/trusty
brew install bobmatnyc/trusty/trusty-search

From source

Requires Rust 1.94. cargo install writes atomically — never copy a built binary onto your PATH on macOS.

git clone https://github.com/bobmatnyc/trusty-tools
cd trusty-tools
cargo install --path crates/trusty-search --locked

Managed by tctl
trusty-search · trusty-memory · trusty-analyze · trusty-review · tga · trusty-console · trusty-mpm

The bootstrap installer verifies every downloaded tarball against its published SHA-256 checksum. The install script itself is unsigned — read it first if you need higher assurance.

Read the documentation

Guides, references, and architecture decisions for every crate.

Browse docs