Agent Sessions is a local-first Mac app for session history across CLI tools, desktop apps, and app-bundled agent commands. Search local Codex, Claude, OpenCode, Cursor, Copilot, Pi, Gemini, Hermes, and OpenClaw histories, inspect transcripts and images, then resume supported CLI sessions in Terminal.app, iTerm2, or Warp. Agent Cockpit adds a live command center for active iTerm2 Codex CLI, Claude CLI, and OpenCode sessions, plus a tiny Limits Widget for always-on Codex and Claude usage visibility, prediction markers, and Limit Alerts.
The Limits Widget keeps Codex and Claude 5h/weekly usage visible in a tiny always-on window, useful on MacBooks where the menu bar is already crowded and the full Agent Cockpit is more than you need. It now adds freshness-aware run-out predictions, earlier Cockpit ETA markers, a dedicated Limit Alerts pane, and separate controls for predicted exhaustion versus low-threshold warnings. 3.9 also adds shared limit notifications, update-tour guidance for Limits Cockpit, Dock/menu-bar reachability fixes, Unified Window collapse/expand commands, a persistent Transcript Window toggle, Saved-only count labels, scroll-position fixes during live refresh, safer hierarchy collapse behavior, and refreshed agent-format support for current Codex, Claude, Gemini, Copilot, OpenCode, Hermes, OpenClaw, Cursor, and Pi builds.
brew tap jazzyalex/agent-sessions
brew install --cask agent-sessions
Sessions search with transcript preview
Browse local sessions from CLI tools, desktop apps, and app-bundled coding agents in one unified window.
Codex Desktop, Claude Desktop, and Cursor Agent sessions are surfaced beside terminal histories with source-specific labels, archive handling where available, and clearer project context.
Apple Notes-style search across all agents and within a single session.
Inline image support and Image Browser for reviewing visual output from Codex CLI/Desktop, Claude CLI/Desktop, and OpenCode CLI sessions.
The Limits Widget is a small always-on Codex and Claude usage window for MacBook users who want 5h and weekly limits visible without spending menu bar space or opening the full Cockpit. Freshness-aware predictions can show projected run-out ETAs before the final alert window, while Agent Cockpit still provides grouped active and waiting visibility, quick focus jumps, and compact/full cockpit modes.
Limits Widget with 5h burn predictions
Right-click a supported CLI session to copy the exact resume command or open it directly in Terminal.app, iTerm2, or Warp.
Saved Sessions window for managing archived sessions. Delete, reveal, and diagnose with archive status tooltips.
Track Codex CLI and Claude CLI usage in-app, in the menu bar, or in the Limits Widget. Shared notifications can warn when 5h or weekly limits are approaching, exhausted, or projected to run out before reset.
Interactive flip cards with sparklines and insights. Session trends, agent breakdowns, and time-of-day heatmaps.
How Agent Sessions searches Codex CLI, Codex Desktop, and Codex VS Code rollout history from ~/.codex/sessions.
Where OpenCode stores local session data, what Agent Sessions reads, and how to browse/search old OpenCode runs locally.
What Claude Code writes to local JSONL transcripts, what transcript context can be recovered, and where the boundary is.
How Agent Sessions reads Cursor Agent transcripts from Cursor's local storage without claiming full Cursor IDE chat history.
How Hermes Agent sessions in ~/.hermes/state.db become searchable local project history.
How OpenClaw JSONL sessions are discovered, searched, and kept separate from trajectory traces.
Saved Sessions with restore actions
Image Browser for visual session outputs
Menu bar status strip
Analytics dashboard filtered to one project