winget install --id=Tokalang.trg -e Fast, agent-friendly, symlink-safe code search and hydration tool with centered KWIC snippets, stateless point hydration, edit-ready block boundaries, and native Model Context Protocol (MCP) support.
trg is a high-performance, symlink-safe, agent-friendly code search and context hydration CLI tool with native Model Context Protocol (MCP) server support.
Designed for modern AI coding agents and developers, trg recursively searches across any codebase (C/C++, Python, TypeScript, Rust, Go, Java, Markdown, and more) with intelligent syntactic block expansion, enclosing symbol scope breadcrumbs, and LLM-safe token budget protection.
trg symbols, trg_symbols): Streaming single-pass $O(1)$ memory symbol extractor providing edit-ready ranges [start, end], Go receiver methods, TypeScript arrow functions, and decorator upward snapping.trg view, trg_view): Sub-3ms target line inspection with surrounding context (-C N) or full syntactic block expansion (--block).--mcp): Built-in JSON-RPC 2.0 server over stdio for Claude Desktop, Cursor, Antigravity, and AI agent frameworks—zero Node.js or Python runtime required.--max-result-bytes, --max-total-matches), token-efficient compact JSON mode (--json=compact), and atomic context window framing prevent context runaway.--block, --scope, --def-first): Expands matches into full enclosing functions/classes and prioritizes symbol definitions over usages for instant code comprehension.trg symbols [options], trg_symbols MCP Tool):
function, method, class, struct, interface, type, shape, impl), symbol name, parent scope (scope), and exact edit-ready line range (range: [start, end]).func (s *Server[T]) Method()), while ignoring anonymous function closures.const f = () => { ... }) from concise expression bodies (const add = (a, b) => a + b;).@decorator) and attributes (#[derive(...)]), including multiline expressions, with empty-line hard stops.-k / --kind ): Filter symbols by kind (e.g. -k function,method or -k class).--max-symbols and --max-bytes budgets with truthful completeness flags (complete, truncated, termination_reason).trg symbols [--json] [-k kinds] [--max-symbols N] [--max-bytes SIZE]) and MCP stdio (trg_symbols).trg view :, trg_view MCP Tool):
trg view : [-C N] (default 10 lines; recommended for local facts, conditions, and error branches).trg view --lines -.trg view : --block (expands to the enclosing function/class block with decorator snapping).trg view --symbol [--scope ] [--max-lines N] (extracts symbol range; pair with --max-lines on large functions. Note: view --scope is a scope name filter, not a boolean flag).--context-block / --block, --max-block-lines):
--max-block-lines : Guardrail bounding block expansion depth (default: 80). Emits clear truncation notice when capped:
[block context truncated by --max-block-lines ]"block_truncated": true on the cutoff context line, and "block_contexts_truncated" in summary stats.-l, -c, -q, and -o short-circuit block expansion and ring buffer allocation.--scope):
path:line:[scope_name] line_text.trg-json-v2 & compact) provides structured "scope": {"text": "scope_name"} metadata.--def-first):
--max-total-matches, --max-result-bytes).pub, async, export), declaration keywords (fn, struct, class, shape, type), generics (<...>), and impl Trait for Target. Ensures references in parameter or return types are not falsely treated as definitions.--heading, --no-heading, --path-style):
--heading: Group matches under file path headings with blank line separators (default when stdout is an interactive TTY and searching multiple files).--no-heading: Output flat lines prefixed with file path (path:line:text / path-line-text).