What is Aspy?
Aspy sits between Claude Code and the Anthropic API, giving you a live view of everything happening under the hood. Every tool call. Every response. Every token. All in a terminal interface that stays out of your way until you need it.
Real-time Visibility
Watch tool calls, API requests, and responses the moment they happen. No more wondering what Claude is doing or thinking.
Detailed Statistics
Token usage with sparklines, model breakdowns, tool call counts, and execution times. A full stats dashboard at your fingertips.
Multi-Session Support
Run multiple Claude Code instances through a single proxy. Each session tracked independently.
Thinking Blocks
Peek into Claude's reasoning process. Understand the "why" behind the actions.
32 Themes & Custom
Make your terminal beautiful. Built-in themes from Dracula to Solarized, plus full TOML custom theme support.
Context Recall & Cortex
SQLite-backed search across all sessions. Hybrid semantic + keyword search lets Claude recall what it forgot—even with different wording.
Why Use It?
When I use Claude Code without Aspy now, I feel blind. Genuinely.
Once you see the full picture—which tools get called, how tokens flow, when cache hits happen—you start making better prompts. You debug faster. You understand why something worked (or didn’t).
What you gain:
- Prompt engineering intuition — See exactly how your words translate to actions
- Cost awareness — No more surprise token bills; watch consumption in real-time
- Debugging superpowers — When something breaks, you’ll know where and why
- Deeper understanding — Learn how Claude Code actually operates
Documentation
Getting Started
- Quick Start — Install and run in 5 minutes
- Features — Everything Aspy can do
- Sessions — Multi-client routing setup
Using the TUI
- Views — Events, Stats, and Settings
- Themes — 32 built-in + custom TOML themes
- CLI Reference — Configuration commands
Advanced
- API Reference — REST endpoints
- Log Analysis — jq queries and session recovery
- Semantic Search — Embedding providers and hybrid search
- Request Transformers — Edit XML tags, system prompts, inject context
- API Translation — Use Claude Code with any OpenAI-compatible backend
- OpenTelemetry — Export to Azure Application Insights
- Architecture — Design patterns and internals
Latest Posts
-
The Handoff
Something unexpected happened today during context compaction.
-
Never Ask a Model Who They Are
The translation feature shipped. Time to test it for real.
-
Speaking in Tongues
Remember the first post? Where I mentioned starting with something “completely different”?