Tool for visualizing parts of your codebase an LLM agent has stored within a session log.
- Monitors Claude Code’s JSONL session logs in real time
- Colors each symbol by how deeply the agent has read it: unseen, name-only, overview, signature, or full body
- Detects when source files change and marks previously-read symbols as stale
- Supports parsing Serena MCP symbol artifacts.
- Supports Tree sitter parsing for
- Symbol dumps and coverage reports
- Multi agent hierarchies
- Multi session visualization
Tree-sitter parsing
Requires Rust 1.70+.
| Flag | Description |
|---|---|
--project, -p |
Path to the project root (required) |
--session, -s |
Session ID to track (auto-detects latest) |
--dump |
Print symbol tree to stdout and exit |
--coverage |
Print coverage report to stdout and exit |
--serena |
Use Serena’s LSP symbol cache instead of tree-sitter |
--log-dir |
Path to Claude Code log directory (auto-derived) |
--log-output |
Output directory for event logs |
# Launch TUI for current project
ambits -p .
# Dump symbol tree without TUI
ambits -p . --dump
# Print coverage report
ambits -p . --coverage
# Use Serena's symbol cache (more languages, finer detail)
ambits -p . --serena
The --coverage flag outputs a tabular report showing per-file symbol visibility:
Coverage Report (session: 34e212cf-a176-4059-ba12-eca94b56e43b)
─────────────────────────────────────────────────────────────────────────────
File Symbols Seen Full Seen% Full%
─────────────────────────────────────────────────────────────────────────────
src/events.rs 3 0 0 0% 0%
src/parser/mod.rs 8 8 1 100% 12%
src/app.rs 23 23 23 100% 100%
─────────────────────────────────────────────────────────────────────────────
TOTAL 214 182 175 85% 82%
- Seen%: Symbols the agent has any awareness of (name, overview, signature, or full body)
- Full%: Symbols the agent has read completely (full body)
ambits ships with a Claude Code skill that lets you check coverage directly from a Claude Code session using /ambit.
# Install globally (available in all your projects)
ambits skill install --global
# Install into the current project only
ambits skill install
# Install into a specific project
ambits skill install --project /path/to/project
Global installs go to ~/.claude/skills/ambit/. Project installs go to .claude/skills/ambit/ within the target directory.
Once installed, use /ambit in Claude Code:
/ambit # Check coverage for current project
/ambit --session # Check a specific session
Claude will run the appropriate ambits commands and interpret the coverage results, highlighting blind spots and suggesting files to read for better understanding.
| Key | Action |
|---|---|
j / k |
Navigate up/down |
h / l |
Collapse/expand |
Enter |
Toggle expand |
/ |
Search symbols |
a |
Cycle agent filter |
Tab |
Switch panel focus |
q |
Quit |
| Color | Meaning |
|---|---|
| Dark gray | Unseen |
| Light gray | Name only (appeared in glob/listing) |
| Pale blue | Overview (grep match, symbol listing) |
| Blue | Signature seen |
| Green | Full body read |
| Orange | Stale (source changed since last read) |