Skip to content

Agent Sessions

v2.7 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agentic-workflow ai ai-coding-agents anthropic claude-code codex
+14 more
codex-cli copilot-cli cursor-agent developer-tools hermes-agent local-first macos openai openclaw opencode session-history session-management transcript-search usage-tracking

Summary

AI summary

Updates Critical Fixes, Major Features, and Technical across a mixed release.

Full changelog

Major Features

  • New Color View: Terminal-inspired view with CLI-style colorized output, role-based filtering (User, Agent, Tools, Errors), and navigation shortcuts. Replaces the old "Terminal" mode with enhanced visual hierarchy and interactive filtering.
  • Enhanced Transcript Modes: Renamed "Transcript" to "Plain" view for clarity. Added improved JSON viewer with syntax highlighting and better readability for session inspection.
  • View Mode Switching: Quick toggle between Plain, Color, and JSON views with Cmd+Shift+T keyboard shortcut.

Critical Fixes

  • Claude Usage Tracking: Fixed compatibility with Claude Code's new usage format change ("% left" vs "% used"). The usage probe now supports both old and new formats with automatic percentage inversion, ensuring accurate limit tracking across all Claude CLI versions.
  • Script Consolidation: Unified usage capture scripts via symlink to prevent future divergence. Single source of truth in AgentSessions/Resources/.

Improvements

  • Color View Navigation: Added role-specific navigation buttons with circular pill styling and tint-aware colors. Jump between user messages, tool calls, or errors with keyboard shortcuts.
  • NSTextView Renderer: Implemented high-performance text rendering with native macOS text selection and smooth scrolling.
  • JSON View: Redacted encrypted_content fields for cleaner inspection. Improved syntax coloring stability across mode toggles.
  • Debug Mode: Added CLAUDE_TUI_DEBUG environment variable for troubleshooting usage capture issues with raw output dumps.

Technical

  • Flexible Pattern Matching: Usage probe now tries multiple patterns ("% left", "% used", "%left", "%used") with fallback to any "N%" format. Future-proofed against CLI format changes.
  • Enhanced Testing: Comprehensive test suite for both old and new Claude usage formats with validation of percentage inversion logic.

Breaking Changes

  • Renamed "Transcript" view to "Plain"

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track Agent Sessions

Get notified when new releases ship.

Sign up free

About Agent Sessions

Local-first macOS app to browse, search, analyze, and resume supported AI coding-agent session history across Codex, Claude Code, OpenCode, Cursor Agent, Hermes, OpenClaw, Copilot CLI, and more.

All releases →

Related context

Beta — feedback welcome: [email protected]