tsq

Purpose

Use this skill when you need structured, language-aware insight into code: declarations, references, outlines, and precise AST pattern matches. tsq is best for targeted extraction and analysis that would be noisy with text search.

When to use what

• tsq query: Use for custom AST patterns and precise structural matching. Best when you need specific constructs or relationships in the syntax tree.
• tsq symbols: Use to catalog declarations (functions, types, methods, variables) across files for indexing or summaries.
• tsq outline: Use to get a high-level file structure (package/module, imports, top-level symbols) when you need quick orientation.
• tsq refs: Use to find usages of a symbol across a codebase.
• tsq example-queries: Use only to discover query syntax and patterns. It is a reference, not a required step.

Core concepts

• Tree-sitter queries use capture names (e.g., @name) to extract data. Queries without captures return matches with no usable payload.
• Use --file for a single file, --path to scan a directory.
• Prefer symbols or outline when you do not need a custom query.

Recommended workflow