# Cymbal

> Use this skill when the user wants to navigate code, trace dependencies, investigate symbols, or analyze the impact of changes across a codebase.

- Skill: `javimosch/cymbal` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/cymbal`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/cymbal/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/cymbal

---


# cymbal Plugin

Language-agnostic code navigation CLI powered by tree-sitter.

## Commands

### Symbol
- `cymbal symbol investigate` — Investigate a symbol (source + callers + impact)
- `cymbal symbol trace` — Trace dependencies of a symbol
- `cymbal symbol impact` — Show upstream blast radius of a symbol

### Repo
- `cymbal repo index` — Build or refresh the repo index

## Usage Examples
- "Investigate the handleAuth function"
- "Trace dependencies of UserModel"
- "Show the impact of changing this symbol"
- "Index the current repository"

## Installation

```bash
brew install 1broseidon/tap/cymbal
```

## Examples

```bash
# Investigate a symbol
cymbal investigate handleAuth

# Trace with graph
cymbal trace handleAuth --graph

# Impact analysis
cymbal impact handleAuth

# Index repo
cymbal index .
```

## Key Features
- Tree-sitter powered parsing
- SQLite-based incremental indexing
- Dependency tracing and impact analysis
- Graph output (Mermaid, dot, JSON)
- Batch mode for multiple symbols
- Auto-refreshes on code changes