Skip to content

Agent Sessions

v2.8 Breaking

This release includes breaking changes 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 Website, Codex, and sleep/screensaver/locked across a mixed release.

Full changelog

🦃 My thanks to the OpenCode community - Agent Sessions now supports OpenCode! (Resume and usage tracking are on the roadmap.)

Added

  • OpenCode Support: Full session browser integration with Claude Code OpenCode sessions, including transcript viewing, analytics, and favorites. Sessions appear in the unified list with source filtering.
  • Preferences → Claude Code: Sessions Directory override to choose a custom Claude sessions root. The Claude indexer honors this path and refreshes automatically when changed. Defaults to ~/.claude when unset.
  • Preferences → Usage Probes: New dedicated pane consolidating Claude and Codex terminal probe settings (auto-probe, cleanup, and one‑click delete), with clear safety messaging.

Changed

  • Preferences → Usage Tracking: Simplified and HIG‑aligned. Added per‑agent master toggles (Enable Codex tracking, Enable Claude tracking) independent of strip/menu bar visibility. Moved all probe controls into the new Usage Probes pane. Reduced vertical scrolling and clarified refresh interval and strip options.
  • Usage Tracking: Separate refresh intervals per agent. Codex offers 1/5/15 minutes (default 5m). Claude now offers 3/15/30 minutes (default 15m) and /usage probes no longer send user messages, so they don't consume tokens.
  • Usage probes run directly on their configured cadence. The legacy UsageProbeGate visibility/budget guard has been removed so Claude and Codex refreshers no longer stall after 24 attempts.
  • Website: Updated Open Graph and Twitter Card tags to use the AS-social-media.png preview so shared links render the large social image correctly.

Fixed

  • Usage Probes: Codex and Claude cleanup actions once again emit status notifications for disabled/unsafe exits and successfully delete Codex probe sessions that log their working directory inside nested payload data.
  • Usage (Codex): Stale indicator now reflects the age of the last rate‑limit capture only. Recent UI refreshes or token‑only events no longer mask outdated reset times; the strip/menu will show "Stale data" until fresh rate_limits arrive.
  • Claude Usage: Added a central probe gate that suppresses /usage probes when the menu bar limits are off and the main window isn't visible, or when the screen is inactive (sleep/screensaver/locked).
  • Claude Usage Probes: Cleanup now verifies every session file's cwd/project matches the dedicated probe working directory, requires tiny (≤5 event) user/assistant-only transcripts, and aborts deletion when uncertain.

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]