pi-shazam

Codebase awareness toolkit for the Pi coding agent — 7 structural analysis tools powered by tree-sitter and LSP that give your agent deep understanding of any project.

Installation

Two ways to use pi-shazam, depending on your agent:

Native Extension — Pi Coding Agent only

For the Pi coding agent. Installs as a first-class extension — tools appear alongside read/write/bash with no distinction.

pi install npm:pi-shazam

MCP Server — all other AI agents

For Kimi Code, CodeBuddy, Qwen Code, Claude, Codex, Qoder, Trae, and any MCP-compatible client.

{
	"mcpServers": {
		"pi-shazam": {
			"command": "npx",
			"args": ["-y", "-p", "pi-shazam@latest", "pi-shazam-mcp"]
		}
	}
}

Analysis Tools

| Tool | When to use | What it does | | ---------------------- | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | | shazam_overview | First entry, need project structure | Project summary: top files, dependencies, hotspots, entry points, key data structures | | shazam_lookup | Need symbol details or concept search | Unified lookup + fuzzy concept search ("how is X implemented") | | shazam_impact | Before editing shared or exported modules | Blast radius analysis — every file, symbol, and test affected by a change | | shazam_verify | After every write or edit | Post-edit verification: LSP diagnostics with auto-detection of unreliable servers, graph analysis, PASS/WARN/FAIL | | shazam_changes | After edits to see what changed | Git change summary with symbol-level detail, risk level, affected callers | | shazam_format | When shazam_verify reports format errors | Auto-fix formatting (prettier, biome, eslint, ruff, cargo fmt, gofmt) | | shazam_rename_symbol | Before renaming any symbol | LSP cross-file symbol rename with atomic writes |

Slash Commands

Setup and hook installation run automatically on session start. No manual setup commands needed.

| Command | When | Purpose | | ---------------- | -------------------- | ------------------------------------------------------------------------------------------ | | /shazam-doctor | When troubleshooting | Health check: LSP status, recent errors, slow calls, tree-sitter grammars, cache integrity |

Supported Languages

| Language | Tree-sitter | LSP | | ---------- | ----------- | --------------------------- | | Python | Yes | pyright / pylsp | | TypeScript | Yes | typescript-language-server | | JavaScript | Yes | typescript-language-server | | Go | Yes | gopls | | Rust | Yes | rust-analyzer | | Dart | Yes | dart language-server | | JSON | Yes | vscode-json-language-server | | YAML | - | yaml-language-server |

Platform Support

| Platform | Status | | -------- | ----------------------------------------- | | Linux | Supported | | macOS | Supported | | Windows | Supported (cmd, PowerShell 5/7, Git Bash) |

All tree-sitter grammars ship prebuilt binaries for linux-x64, linux-arm64, darwin-x64, darwin-arm64, win32-x64, and win32-arm64 — no C++ compiler required on any platform.

License

MIT