Skip to content

Releases: omgpointless/aspy

v0.1.0

02 Dec 02:17
@omgpointless omgpointless
v0.1.0
9e4a3e0

Choose a tag to compare

View all tags
v0.1.0 Latest
Latest

Initial pre-stable release with full observability features.

Core Observability

  • Proxy Server - Intercepts Claude Code ↔ Anthropic API traffic
  • Tool Call Tracking - Captures tool invocations with timing and correlation
  • Thinking Blocks - Dedicated panel showing Claude's extended thinking in real-time
  • Token & Cost Tracking - Cumulative session statistics with cost estimation
  • SSE Streaming - Proper delta accumulation for streaming responses
  • JSON Lines Logging - Session logs for post-hoc analysis

Views & Statistics

  • Views System - Three main views (Events, Stats, Settings) with keyboard navigation
  • Statistics View - 5-tab dashboard with gauges, charts, and sparklines
    • Overview tab: Session gauges and summary
    • Models tab: API call distribution by model
    • Tokens tab: Token usage breakdown
    • Tools tab: Tool call frequency analysis
    • Trends tab: Sparkline grid for metrics over time

Theme System

  • 32 Bundled Themes - Spy Dark/Light, Dracula, Catppuccin, Nord, Gruvbox, etc.
  • TOML Custom Themes - Create your own themes with full semantic color control
  • Runtime Switching - Change themes via Settings view or config

Configuration

  • Config File - ~/.config/aspy/config.toml
  • CLI Tool - aspy config with --init, --show, --edit, --update, --reset
  • Multi-Client Routing - Track multiple Claude Code instances with named clients
  • Provider Backends - Route to Anthropic, Foundry, Bedrock, etc.

REST API

  • GET /api/stats - Session statistics
  • GET /api/events - Event buffer with filtering
  • GET /api/context - Context window status
  • GET /api/sessions - Active session list
  • POST /api/search - Search past session logs

Documentation

  • docs/api-reference.md - Complete REST API documentation
  • docs/themes.md - Theme system guide
  • docs/cli-reference.md - CLI tool reference
  • docs/views.md - TUI views documentation
  • docs/sessions.md - Multi-client routing details

Installation

Download the appropriate binary for your platform:

Platform Binary
Windows x64 aspy-windows-x64.exe
Linux x64 aspy-linux-x64
macOS Intel aspy-macos-x64
macOS Apple Silicon aspy-macos-arm64

Quick Start

macOS/Linux:
```bash

Make binary executable

chmod +x aspy-*

Run the proxy

./aspy

In another terminal, point Claude Code at the proxy

export ANTHROPIC_BASE_URL=http://127.0.0.1:8080
claude
```

Windows:
```powershell

Run the proxy

.\aspy-windows-x64.exe

In another terminal

$env:ANTHROPIC_BASE_URL="http://127.0.0.1:8080"
claude
```

Full changelog: https://github.com/omgpointless/aspy/blob/main/CHANGELOG.md

Assets 6
Loading

v0.1.0-alpha

26 Nov 01:10
@omgpointless omgpointless
v0.1.0-alpha
20bfd6d

Choose a tag to compare

View all tags
v0.1.0-alpha Pre-release
Pre-release

Installation

Download the appropriate binary for your platform:

Platform Binary
Windows x64 anthropic-spy-windows-x64.exe
Linux x64 anthropic-spy-linux-x64
macOS Intel anthropic-spy-macos-x64
macOS Apple Silicon anthropic-spy-macos-arm64

Quick Start

# Make binary executable (macOS/Linux)
chmod +x anthropic-spy-*

# Run the proxy
./anthropic-spy

# In another terminal, point Claude Code at the proxy
export ANTHROPIC_BASE_URL=http://127.0.0.1:8080
claude

Windows

# Run the proxy
.\anthropic-spy-windows-x64.exe

# In another terminal
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:8080"
claude
Loading