🚀 Release: token-audit v1.0.2 #107

nathanschram · 2025-12-26T10:45:22Z

nathanschram
Dec 26, 2025
Maintainer

Find + fix context bloat & high token usage in your MCP tools.

7 New MCP Tools — Enhanced MCP server with aggregation and session management
- get_daily_summary: Daily token usage aggregation with trends (days parameter, platform filter)
- get_weekly_summary: Weekly token usage aggregation with configurable week boundaries
- get_monthly_summary: Monthly token usage aggregation with model breakdown option
- list_sessions: Query historical sessions with filtering, sorting, and pagination
- get_session_details: Retrieve full session data with smells, tool calls, and recommendations
- pin_server: Add/update/remove pinned MCP servers via MCP protocol
- delete_session: Delete sessions from storage with confirmation safety check
5 New MCP Resources — Usage summaries and session access via MCP resource protocol
- token-audit://usage/daily — Daily usage summary (last 7 days)
- token-audit://usage/weekly — Weekly usage summary (last 4 weeks)
- token-audit://usage/monthly — Monthly usage summary (last 3 months)
- token-audit://sessions — List of recent sessions
- token-audit://sessions/{id} — Detailed session information

Dependencies — Added filelock>=3.12.0 to server extras for concurrent index access
Storage — Index file operations now use atomic writes and file locking for concurrent access safety
- save_daily_index() and save_platform_index() use temp file + rename for crash safety
- update_indexes_for_session() holds file locks during read-modify-write cycles
- Prevents data loss when MCP server, CLI, and TUI run simultaneously

# New install
pipx install token-audit

# Upgrade existing
pipx upgrade token-audit
# or: pip install token-audit

💬 Questions, feedback, or want support for another CLI platform?
Reply here or start a discussion!

Made with 🐻 by Little Bear Apps