ambits-0.3.0 is not a library.
Visit the last successful build:
ambits-0.13.0
ambits
Tool for visualizing parts of your codebase an LLM agent has stored within a session log.
What it does
- 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
- Rust
- Python
- Symbol Dumps (Coverage reports coming soon)
Todo
- Coverage reports
- multi agent heirchies
- Multi session visualization
Supported languages
Tree-sitter parsing
- Rust
- Python
Building from source
Requires Rust 1.70+.
cargo build --release
Installing through Cargo
cargo install ambits
Usage
ambits --project <path>
Flags
| Flag | Description |
|---|---|
--project, -p |
Path to the project root (required) |
--dump |
Print symbol tree to stdout and exit |
--serena |
Use Serena's LSP symbol cache instead of tree-sitter |
--session, -s |
Session ID to track (auto-detects latest) |
--log-dir |
Path to Claude Code log directory (auto-derived) |
Examples
# Launch TUI for current project
ambits -p .
# Dump symbol tree without TUI
ambits -p . --dump
# Use Serena's symbol cache (more languages, finer detail)
ambits -p . --serena
Keybindings
| 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 legend
| 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) |