Skip to main content

symtext

A code-graph indexer for LLM agents. Parses your project with tree-sitter, stores the structure (functions, classes, calls, imports, inheritance) in a local graph database, and serves it to your LLM client over MCP. Supports 24 languages and incremental updates via file-watching.

Quick start

Install uv if you don't have it:

curl -LsSf https://astral.sh/uv/install.sh | sh

Add symtext to your MCP client config:

{
  "mcpServers": {
    "symtext": {
      "command": "uvx",
      "args": ["symtext", "mcp"]
    }
  }
}

Where the snippet goes:

  • Claude Code — ~/.claude.json (user-wide), or <project>/.mcp.json (committed, project-wide). One-liner equivalent: claude mcp add symtext -- uvx symtext mcp.
  • Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
  • Cursor / Cline / Windsurf / VS Code — see docs/install.md.

Open your editor inside any project. First call indexes the repo (seconds for small repos, ~1 min for large); subsequent calls are instant. Everything lives under ~/.symtext/projects/<hash>/ — nothing is written into your project tree. Diagnostics: uvx symtext doctor.

Don't use uv? pipx and plain pip install symtext work too — see docs/install.md.

MCP tools

Tool Purpose
shape Codebase dimensions: node/edge counts, language breakdown, directory tree
summarize Per-file summaries: function counts, class names, top functions by caller count
symbols Full symbol listing for a file or directory
search_symbols Fuzzy search by name or docstring content
get_callers All functions that call a given function, with source context
get_callees All functions that a given function calls
get_importers All files that import a given module
get_dependencies Outbound imports for a file — modules + line numbers
get_hierarchy Class inheritance — ancestors, descendants, or both
path_between Shortest call chain between two functions
unused_symbols Functions with zero callers (dead-code finder, with entrypoint heuristics)
changed_symbols Git-aware blast radius: symbols changed vs a ref + their callers
describe_symbol Full profile: source, callers, callees, imports — one round-trip

The tools form a natural hierarchy: shape (counts) → summarize (per-file) → symbols (every symbol). Start broad, drill down.

Supported languages

24 languages: Bash, C/C++, C#, Dart, Elixir, Go, Haskell, HCL, Java, Kotlin, Lua, Objective-C, Perl, PHP, Protobuf, Python, R, Ruby, Rust, Scala, SQL, Swift, TypeScript/JavaScript, Zig.

Docs

Credits

Built on tree-sitter, graphdblite, and watchfiles. Inspired by codegraphcontext.

License

MIT — see LICENSE.

Metadata

Release files for symtext 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for symtext 0.1.0
File Size Uploaded Provenance Actions
symtext-0.1.0.tar.gz 224.0 kB Without provenance Details for symtext-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for symtext 0.1.0
File Interpreter ABI Platform Actions
symtext-0.1.0-py3-none-any.whl Python 3 none any Details for symtext-0.1.0-py3-none-any.whl

Total release size: 379.7 kB

Release files / symtext-0.1.0.tar.gz

Download URL symtext-0.1.0.tar.gz
Size 224.0 kB
Tags Source
SHA-256 checksum
How to use checksums
dea62ff07a2871ad9b88b41f23b4cb9145aea3bb5473c5c108c5bf324f99eae5
BLAKE2b-256 checksum
How to use checksums
b6eaafe8160b805783e9f8d81b872909d378ad25bc7720af9f38530219cae48a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.17

Release files / symtext-0.1.0-py3-none-any.whl

Download URL symtext-0.1.0-py3-none-any.whl
Size 155.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f9d4c519be345516d2eac6e633aaccc69d58f5c36b3de2fd9c1087cbbf66a8b9
BLAKE2b-256 checksum
How to use checksums
463c23ce0d166dd0f1658c301d7648a375bc2cf81dde467228f30e5232abcc6d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.17

Security for symtext 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page