Agent-native code navigation
v0.9.0Fast, language-agnostic code indexer built on tree-sitter. Designed as an AI agent's code comprehension layer — every command returns exactly what an agent needs to understand and modify code.
brew install 1broseidon/tap/cymbalEvery command returns YAML frontmatter + content body — optimized for LLM token efficiency. Agents parse metadata and read content naturally.
Tree-sitter AST parsing with SQLite FTS5 storage. Index an entire codebase in ~100ms. Incremental re-indexing only touches changed files.
Refs and impact results deduplicate identical call sites — grouped by file with site counts. Agents see patterns, not noise.
Find who calls a function, who imports a package, and what breaks if you change something. Transitive impact analysis in one command.
Go, Python, TypeScript, Rust, C, Java, Ruby, Swift, Kotlin, Scala, PHP, and more. Tree-sitter grammars for accurate AST parsing across your stack.
cymbal context bundles source, types, callers, and imports into a single response. Everything an agent needs to understand and modify code.
# Index the current project (~100ms)
cymbal index .
# Find a symbol and read its source
cymbal search handleAuth
cymbal show handleAuth
# Who calls this? What breaks if I change it?
cymbal refs handleAuth
cymbal refs handleAuth --impact
# Everything an agent needs in one call
cymbal context handleAuth