← ClaudeAtlas

tsa-indexlisted

Manage the persistent AST cache / index. Refresh, force-rebuild, inspect cache state, diff one file's AST between commits, advise on parser readiness for a language. Mostly ops/infra, not daily agent work. Use when: - "Re-index the project" / "force rebuild AST cache" - "Why is callees returning unknown" (likely stale index) - "AST diff this file vs last commit" (structural diff, not text diff) - "What language plugins are ready / which are stubs" - Setting up the project for the first time (autoindex) Replaces: manual `rm -rf .ast-cache && reindex` + reading plugin docs.
aimasteracc/tree-sitter-analyzer · ★ 36 · AI & Automation · score 78
Install: claude install-skill aimasteracc/tree-sitter-analyzer
# tsa-index — Cache / index ops > Not a daily skill. Most agents never need it. Pull when index is stale or > a language plugin behaves oddly. ## Tool routing | Goal | Tool | |------------------------------------------------|-------------------------| | Status / stats of the AST cache | `ast_cache` (mode=status) | | Force rebuild | `ast_cache` (mode=force) | | Incremental refresh | `ast_cache` (mode=index) | | Watch a directory and auto-refresh | `ast_cache` (mode=watch_start) | | AST-level diff of one file across commits | `ast_diff` | | First-time index for a freshly-cloned repo | `codegraph_autoindex` | | Full bulk reindex (large monorepo) | `codegraph_full_index` | | "Is the python plugin / swift plugin ready" | `advise_parser_readiness` | ## Procedure ### When to force rebuild The auto-cache is usually correct. Force rebuild only when: - `--callees` / `--callers` returns `callee_resolution: unknown` consistently AND the symbols clearly exist (means imports not indexed) - Schema migration happened (e.g., new column added — pre-existing rows have defaults) - Files were renamed/moved en masse (mtime-based invalidation may miss this) ```bash uv run tree-sitter-analyzer --ast-cache --ast-cache-mode force # OR safer (preserves what works): uv run tree-sitter-analyzer --ast-cache --