aimasteracc/tree-sitter-analyzer/tsa-deps

tsa-deps — Imports & module topology

Tool routing

Procedure

File-level deps

health action=deps file_path="tree_sitter_analyzer/ast_cache.py" mode="file_deps"
# returns: {imports: [...], imported_by: [...], depth: 2}

mode options:

• summary — project-wide dependency summary (alias: full)
• file_deps — one file's graph (requires file_path)
• blast_radius — impact set for a file (alias: blast; requires file_path)
• cycles — circular dependencies

Import graph (project-level)

health action=imports language="python" limit=50
# returns: ranked list of import hubs + leaves

Use to find:

• Hubs (many things import this) — high blast radius if changed
• Leaves (no one imports this) — possibly dead, or a CLI entry point
• Cycles — circular imports needing breaking

Sitemap

structure action=sitemap
# returns: {entry_points: [...], hub_modules: [...], leaf_modules: [...]}

Useful as a "first look" right after tsa-landing.

CLI equivalents

uv run tree-sitter-analyzer <file> --dependencies file_deps
uv run tree-sitter-analyzer --dependencies summary
uv run tree-sitter-analyzer --import-graph --import-graph-mode summary
uv run tree-sitter-analyzer --codegraph-sitemap

Anti-patterns

• DON'T grep for ^import / ^from to build a graph — incomplete (misses

conditional / lazy imports captured by the AST)

• DON'T worry about leaves at the start — they're often legitimate (CLI mains,

examples). Focus on hubs.

• DON'T extract a hub module without first checking its imported_by list

— you'll break dozens of callers.