trelix

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/sairam0424-trelix

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

8 read · 4 write · 2 delete · 1 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (15)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• agent_clear_session

  Delete a persisted agent session and all its turn history. Args: repo_path: Absolute path to the repository root. session_id: The session to delete. Returns: {"cleared": bool, "session_id": str}

• agent_list_sessions

  List recent agent sessions for a repo, most recently active first. Args: repo_path: Absolute path to the repository root. limit: Max sessions to return (default 50). Returns: {"sessions": [{"session_id", "created_at", "last_active_at", "query", "turn_count"}, ...], "count": int}

• ask_agent

  Ask a question using the multi-turn ReAct agentic loop, with persistent memory. ⚠️ IMPORTANT: - repo_path must be an ABSOLUTE path to an already-indexed repository. - Session history is scoped to (repo_path, session_id) — a session_id created against one repo is invisible when querying a different repo_path. - Requires LLM configuration (e.g. OPENAI_API_KEY) — this tool always uses the agentic loop, unlike search_code which is retrieval-only. 🎯 When to Use: - Multi-step questions needing iterative retrieve/grep/get_symbol drilling. - Follow-up questions in the same conversation — pass b…

• blast_radius

  Find all symbols that depend on (call or import) a given symbol. Useful for impact analysis: "if I change X, what else might break?" Args: symbol_name: Name or qualified name of the symbol to analyse. repo_path: Absolute path to the repository root. Answered from the resolved call edges in the index, not by semantic search. This used to build `f"blast radius dependencies of {symbol_name}"` and run it through the Retriever, which never touched the `calls` table. Measured on trelix's own index for `AuditStore.append`: a SQL join over `calls` returns 320 caller symbols across 101 file…

• build_knowledge_graph

  Build a knowledge graph for an indexed codebase. ⚠️ IMPORTANT: Run index_codebase first. repo_path must be absolute. 🎯 What this builds: - Unified code property graph (calls + imports + type hierarchy) - Community detection: clusters modules into architectural groups - Optional LLM concept extraction. extract_concepts=True is PAID: up to 10 LLM calls over the 200 most central symbols (batches of 20), and it requires an LLM API key. It does NOT cover the repository — on trelix's own 12,184-symbol index those 200 symbols are 1.6% of it — so concept_count describes that sample. Selecti…

• federation_add_repo

  Register a repo for federated search across MCP tool calls. ⚠️ IMPORTANT: - path must be an ABSOLUTE path. - Run index_codebase on it separately before federation_search_all can return results from it — registering a repo does not index it. - The registry is capped at TRELIX_FEDERATION_MAX_REPOS entries (default 50) to prevent unbounded growth from a scripted client. Args: alias: Short unique name for the repo (e.g. "auth-service"). path: Absolute path to the repo root. weight: RRF weight multiplier (default 1.0; higher = ranked higher in federation_search_all's fused…

• federation_list_repos

  List all repos registered for federated (multi-repo) search. Args: config_path: Optional path to a custom repos.json. Must resolve inside ~/.config/trelix/ or <cwd>/.trelix/. Defaults to ~/.config/trelix/repos.json. Returns: {"repos": [{"alias": str, "path": str, "weight": float}, ...], "count": int, "error": str|None}

• federation_remove_repo

  Unregister a repo from federated search by alias. Args: alias: The alias to remove. No-op (removed=False) if not registered. config_path: Optional path to a custom repos.json. Must resolve inside ~/.config/trelix/ or <cwd>/.trelix/. Returns: {"removed": bool, "alias": str, "error": str|None}

• federation_search_all

  Search across ALL registered repos simultaneously (federated search). ⚠️ IMPORTANT: - Requires repos to already be registered via federation_add_repo AND already indexed (run index_codebase on each repo path beforehand). - Results are merged via Reciprocal Rank Fusion weighted by each repo's registered weight, then deduplicated. - Only the first TRELIX_FEDERATION_MAX_REPOS registered repos (default 50) are actually queried; repos_skipped reports how many were omitted. 🎯 When to Use: - Cross-service / cross-repo questions ("where is auth handled across our microservices?") - You do…

• get_symbol

  Look up a symbol by its fully-qualified name. Args: qualified_name: e.g. "MyClass.my_method" or "my_function". repo_path: Absolute path to the repository root. Returns: Symbol dict or None if not found. Keys: name, qualified_name, kind, file, line_start, line_end, signature, docstring, body, language.

• graph_search_mcp

  Graph-traversal search: find structurally related symbols by starting from semantically similar seeds and following code relationships. ⚠️ IMPORTANT: Run index_codebase and optionally build_knowledge_graph first. 🎯 When to use: - "What other code is connected to X?" — follow call/import/type edges - "Find the blast radius of a class" — who calls or imports it? - "What lives in the same architectural cluster as X?"

• index_codebase

  Index a repository for code search. Run once before calling search_code. ⚠️ IMPORTANT: - Stores the index in <repo_path>/.trelix/index.db (zero external infra). - Re-run to refresh after large code changes; incremental update is fast. ✨ Providers: - local — no API key, CPU-only, fast for small repos - openai — requires OPENAI_API_KEY, best quality - azure — requires AZURE_API_KEY + AZURE_ENDPOINT - voyage — requires VOYAGE_API_KEY, best code-specific quality Defaults to TRELIX_EMBEDDER_PROVIDER (or "local" if that's unset too). Progress notifications are sent if the MCP client suppor…

• search_code

  Search the indexed codebase using natural language queries. ⚠️ IMPORTANT: - repo_path must be an ABSOLUTE path to an already-indexed repository. - Run index_codebase first if you receive an error about a missing index. 🎯 When to Use: - Find specific functions, classes, or implementations - Understand architecture before making changes - Locate all callers of a function before refactoring - Find similar patterns to follow when adding code 📄 Pagination: - Use cursor=0 for first page (default). - If next_cursor is not null, pass it as cursor for the next page. - k controls page size. 🧭 Int…

• subscribe_resource

  Register a subscription for a trelix:// resource URI. MCP clients call this after receiving resources.subscribe=True in capabilities. When the resource changes (e.g. trelix watch detects a file edit), the server pushes notifications/resources/updated carrying only the URI — no content. The client then calls resources/read to fetch the updated content. Args: uri: The trelix:// resource URI to watch (e.g. trelix://repo//path/manifest). subscription_id: Client-chosen correlation ID included in _meta of notifications.

• unsubscribe_resource

  Deregister a resource subscription by its subscription ID. Args: subscription_id: The ID returned when subscribe_resource was called.

Signals

Weekly downloads

126

Last release

Oct 4, 2026 (26 days ago)

Last package publish

Oct 4, 2026 (26 days ago)

From the package registry.

Details

Registry name

io.github.sairam0424/trelix

Version

3.4.3

Auth

No auth

Packages

pypi trelix-mcp

License

MIT

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registry