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
docs/install.md— install variants, MCP setup, troubleshootingdocs/cli.md— CLI referencedocs/configuration.md— settings, env vars, monorepo overridedocs/storage.md—~/.symtext/layoutdocs/security.md— threat model, disk-read clamp, Cypher hardeningdocs/architecture.md— module layout (full spec inSPEC.md)CHANGELOG.md,CONTRIBUTING.md,SECURITY.md
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.