bobmatnyc/trusty-tools

웹사이트: trustytools.dev

전체 trusty-* AI 툴링 에코시스템을 통합하는 Rust 워크스페이스입니다. 이 워크스페이스는 코드 검색, 메모리, 분석, 오케스트레이션, 리뷰 및 운영자 인터페이스를 하나의 Cargo 워크스페이스에 결합합니다. 라이브 패키지 인벤토리는 cargo metadata에서 가져옵니다.

; 사람이 읽기 쉬운 맵은 docs/reference/crate-map.md입니다.

.

얻게 되는 것:

• trusty-code와 같은 전문 에이전트에게 코딩 작업을 위임하는 PM 스타일 Claude Code 세션 오케스트레이션

(tcode) - 후크 중계가 포함된 멀티 프로젝트 세션 관리

• Claude Code 세션에 노출되는 MCP 서버
• TUI 대시보드 (tm tui) 및 Telegram 봇 (tm telegram pair)

빠른 시작:

cargo install --git https://github.com/bobmatnyc/trusty-tools trusty-mpm --locked
tm start
tm launch

전체 문서는 crates/trusty-mpm/README.md를 참조하십시오.

시맨틱 검색, 영구 임베딩 인덱스 및 내장된 Svelte UI를 갖춘 장기 메모리 저장소입니다. 개발 컨텍스트, 노트, 스니펫을 저장하고 자연어를 통해 검색할 수 있습니다.

얻게 되는 것:

• redb에 영구적으로 저장되는 순수 Rust HNSW 벡터 인덱스 (hnsw_rs) + fastembed 임베딩 - 저장된 모든 메모리에 대한 시맨틱 검색
• 컬렉션 구성 (노트, 스니펫, 코드 패턴, 결정)
• 탐색 및 편집을 위한 Svelte UI
• Claude Code 통합용 MCP 서버

빠른 시작:

cargo run -p trusty-memory -- serve
# 또는 MCP stdio를 통해:
# ~/.claude/claude_desktop_config.json에 추가:
...

MCP 도구: 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

crates/trusty-memory/README.md에서 전체 문서를 확인하세요.

하이브리드 BM25 + 벡터 + 지식 그래프 융합을 거쳐 상호 순위 융합(Reciprocal Rank Fusion)으로 결합된 기계 전반 코드 검색 데몬입니다. 머신당 설치 한 번, 무제한의 이름 지정 프로젝트 인덱스를 지원합니다.

주요 기능:

• 10만 청크 인덱스에서 p50 기준 10ms 미만의 빠른 조회 지연 시간(latency)
• 지능형 쿼리 라우팅 (정의 / 사용법 / 개념적 / 버그 부채 의도 감지)
• 호출자/피호출자 체인을 통한 지식 그래프 확장
• 브랜치 인식 검색 (현재 기능 브랜치에서 결과를 향상)
• 자동 조정 메모리 계층(Auto-tuned memory tiers) (8 GB부터 64+ GB RAM까지 5개 계층 지원)
• 내장된 Svelte 5 관리자 UI
• OpenRouter 기반 채팅 및 자동으로 주입되는 검색 컨텍스트

빠른 시작:

cargo install trusty-search
trusty-search start
trusty-search index ~/Projects/myproj --name myproj
...

MCP 도구: 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

, console_metrics

crates/trusty-search/README.md에서 전체 문서를 확인하세요.

빠른 로컬 PR 검토 서비스: 검색 및 분석 컨텍스트를 갖춘 LLM 기반 코드 리뷰로, AWS Bedrock 또는 OpenRouter를 통해 GitHub PR과 통합 diff를 검토합니다.

주요 기능:

• GitHub PR diff를 가져오고 trusty-search에서 코드 컨텍스트와 trusty-analyze에서 복잡도 데이터를 검색한 후, LLM을 호출하여 구조화된 리뷰 판결문을 생성합니다.
• 단발성 CLI(run/compare)로 배포되며, JSON-RPC 2.0 / MCP stdio 서비스(mcp) 및 trusty-console에 의해 생성되는 전송별 웹훅 드레인(webhook drain)을 제공합니다 - 기본적으로 건너뛰기 모드(Dry-run)입니다 — PR 댓글 게시를 위해서는 명시적인 --live 플래그가 필요하며, 프로젝트별 설정과 이름 지정된 리뷰 템플릿을 지원합니다.

빠른 시작:

cargo install --git https://github.com/bobmatnyc/trusty-tools trusty-review --locked
trusty-review run owner repo 123

MCP 도구: review_pr

, review_diff

, review_health

전체 문서는 crates/trusty-review/README.md를 참조하세요.

trusty-search용 정적 코드 분석 사이드카: 순환 복잡도(cyclomatic) 및 인지 복잡도(cognitive complexity), 코드 냄새(code smells), 품질 등급(quality grading), git 시간 경과 감쇠(git temporal decay), 개념 클러스터링(concept clustering),
SCIP protobuf 수집(ingest), 그리고 (주어, 술어, 목적어)
로 구성된 redb 기반 사실 저장소. trusty-search로부터 HTTP를 통해 청크 코퍼스를 읽고, Unix 소켓을 통해 데몬 RPC 서비스를 제공하며, stdio를 통해 MCP를 노출합니다.

제공되는 기능:

• 청크/파일/인덱스별 순환 복잡도 및 인지 복잡도
• 이름 지정된 임계값과 함께 구성 가능한 코드 냄새 카테고리
• A–F 품질 등급 집계
• Git blame 기반 시간 경과 감쇠 점수 산정 (오래된 고복잡도 코드)
• k-means 개념 클러스터링 (BoW 또는 신경망 임베딩)
• 출처(provenance)가 있는 타입화된 지식 삼중항을 redb에 영구 저장하는 사실 저장소
• LSP급 심볼 데이터를 위한 SCIP protobuf 수집
• 문서 주석에 대한 선택적 ONNX 기반 NER (기능 게이팅: --features ner)
• Rust, TypeScript, JavaScript, Python, Java, Go, Ruby, PHP, C, C++, C#, Kotlin, Swift, Scala용 Tree-sitter 어댑터
• Unix 소켓 JSON-RPC + MCP 동등성 (모든 메서드가 도구(tool)와 동일함)

빠른 시작:

# 1. trusty-search가 먼저 실행되어야 합니다 — 이는 필수적인 런타임 종속성입니다
cargo run -p trusty-search -- start
# 2. 분석 사이드카를 시작합니다
...

MCP 도구: analyzer_health

, complexity_hotspots

, find_smells

, analyze_quality

, list_facts

, upsert_fact

, delete_fact

, ingest_scip

, cluster_concepts

전체 문서는 crates/trusty-analyze/README.md를 참조하세요.

위에 언급된 5개의 핵심 크레이트(crate)는 각각 자체 README 링크와 빠른 시작 가이드를 가지고 있습니다.

이것은 워크스페이스의 나머지 부분을 위한 개요 지도일 뿐, 두 번째 패키지 레지스트리는 아닙니다. 패키지 이름, 버전, 게시 가능 여부 및 타겟팅 정보는 cargo metadata --no-deps --format-version 1을 사용하십시오.

; 모든 패키지에서 매니페스트(manifest), 소스 코드 및 문서로 직접 연결되는 링크가 필요하면 크레이트 맵(crate map)을 사용하십시오.

tga

(git analytics, 이전에는 crates/trusty-git-analytics 디렉토리였던) 및
trusty-audit

(auditor handoff client, bin trusty-audit

및 taudit

, 그리고
trusty-audit-ui

)를 bobmatnyc/trusty-git-analytics에서 빌드, 릴리스 및 게시합니다.
tctl install tga

은 여전히 tga를 설치하지만;
tctl install

은 이름으로 trusty-audit를 받지 않습니다.

┌───────────────────────────────────────────────────────────────┐
│ User surfaces: tm · tcode · tagent · tctl · GUIs │
└──────────────────────────────┬────────────────────────────────┘
...

이것은 의존성 그래프가 아닌 역할(role) 뷰입니다. Cargo manifest가 컴파일 타임 에지(compile-time edges)에 대한 권위적인 출처이며, 런타임 에지는 크레이트 맵과 해당 크레이트의 README에서 문서화됩니다.

trusty-tools를 처음 사용하시나요?

엔지니어: 가장 빠르게 작동하는 세션을 얻으려면 사용자 노트북에 trusty-mpm (tm) 설치 및 실행부터 시작하세요. claude-mpm에서 마이그레이션하는 경우: 무엇이 변경되었고 어떻게 마이그레이션해야 하는지 이해하려면 claude-mpm 대 trusty-mpm — 차이점 및 설치를 읽어보세요. 개발자: 아래의 빌드 및 테스트 명령어를 참고하세요.

하나의 명령어로 전체 trusty-tools 플랫폼을 설치합니다 (Rust 툴체인 필요 없음):

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

이것은 미리 빌드된 trusty-installer 바이너리(SHA-256 검증)를 다운로드하고, 이를 ~/.local/bin에 설치하며, 나머지 플랫폼(검색, 메모리, 분석, 리뷰, 콘솔)을 설정하기 위해 trusty-installer install을 실행합니다. 또한 tctl 전환 별칭도 설치되므로 기존의 근육 기억 명령어(tctl install, tctl status 등)가 계속 작동합니다.

비대화형 (CI / 스크립트):

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

옵션 (환경 변수):

지원 플랫폼: macOS (Apple Silicon), Linux x86_64, 및 Linux arm64 (aarch64-unknown-linux-gnu). macOS Intel은 지원하지 않으며, cargo install trusty-installer로 소스 빌드해야 합니다.

보안: 설치 프로그램은 HTTPS를 통해 제공되며 다운로드되는 모든 바이너리는 게시된 체크섬과 SHA-256 검증됩니다. 설치 스크립트 자체는 서명되지 않았으므로, 더 높은 확신이 필요하면 실행 전에 검토하십시오: https://github.com/bobmatnyc/trusty-tools/blob/main/install.sh

tctl

— 위의 부트스트랩 스크립트가 PATH에 배치하는 trusty-installer 바이너리는 관리되는 애플리케이션 세트를 위해 권장되는 경로입니다:
trusty-search,
trusty-memory,
trusty-analyze,
trusty-review,
trusty-console,
trusty-mpm,
및 tga.

이 명령어는 이들을 함께 설치하고, 업그레이드하며, 어떤 것이 데몬으로 실행되는지 알고 있으며, 자체 제어 평면(control-plane) 바이너리를 업데이트할 수 있습니다. 라이브 세트는 stable_set.rs에 정의되어 있습니다.
tga

은 bobmatnyc/trusty-git-analytics 릴리스에서 오며, crates.io로부터의 cargo install이 대체 수단입니다.

tctl install # 전체 관리 세트
tctl install trusty-search # 개별 멤버
tctl install trusty-search --dry-run
...

아래 Homebrew는 다른 것이 전혀 필요 없고 단지 하나의 바이너리만 원하는 경우의 대안입니다.

패키지 관리자를 통해 개별 trusty-* 바이너리를 설치합니다. 먼저, tap을 추가하십시오:

brew tap bobmatnyc/trusty

그런 다음 필요한 모든 게시된 바이너리를 설치합니다:

brew install trusty-analyze
brew install trusty-audit
brew install trusty-code
...

trusty-audit와 trusty-git-analytics는 이 저장소가 아닌 bobmatnyc/trusty-git-analytics에서 빌드됩니다.

또는 하나의 명령어로 결합할 수 있습니다:

brew install bobmatnyc/trusty/trusty-search \
bobmatnyc/trusty/trusty-memory \
bobmatnyc/trusty/trusty-analyze \
... 

최신 소스에서 빌드하거나 Homebrew를 통해 배포되지 않은 크레이트(crate)가 필요한 경우:

git clone https://github.com/bobmatnyc/trusty-tools
cd trusty-tools
# 모든 크레이트를 빌드합니다
... 

cargo build # 모든 크레이트, 디버그 모드
cargo check -p <크레이트 이름> # 가장 빠른 크레이트 범위 검사
cargo test -p <크레이트 이름> --no-fail-fast # 하나의 크레이트에 있는 모든 타겟 테스트
... 

기능 게이팅된(feature-gated) 크레이트와 위험 기반 테스트 사다리(risk-based test ladder)는 CLAUDE.md를 참조하십시오. 베어 워크스페이스 테스트는 일반적인 내부 루프가 아닌 강화 게이트입니다.

단일 진실 공급원 (Single source of truth): 모든 크레이트는 crates/ 아래에 함께 위치하며,
하나의 워크스페이스 루트와 하나의 Cargo.lock을 사용합니다.
따라서 여러 크레이트에 걸쳐 발생하는 변경 사항은 단일 커밋으로 처리됩니다.

MSRV: Rust 1.94 이상 (aws-config / aws-sdk-bedrockruntime 의존성에서 요구됨)

라이선스: 워크스페이스 패키지의 기본값은 MIT입니다. 각 패키지 매니페스트는 중첩된 비공개 UI 패키지를 포함하여, 해당 패키지가 워크스페이스 필드를 상속받지 못할 수 있더라도 권위적입니다.