|
Unified session browser for Codex CLI, Claude Code, Gemini CLI, and OpenCode (read‑only). |
Download Agent Sessions 2.8.1 (DMG) • All Releases • Install • Resume Workflows
Agent Sessions 2 brings Codex CLI, Claude Code, and Gemini CLI together in one interface.
Look up any past session — even the ancient ones /resume can’t show — or browse visually to find that perfect prompt or code snippet, then instantly copy or resume it.
Local-first, open source, and built for terminal vibe warriors.
Transcript view with search (Dark Mode)
Resume any Codex CLI and Claude Code session
Menu bar usage tracking with 5-hour and weekly percentages
Analytics dashboard with session trends and agent breakdown (Dark Mode)
Git Context Inspector showing repository state and historical diffs (Light Mode)
Automatic background probes refresh Codex usage limits when data goes stale. New Usage Probes preferences pane provides full control: enable/disable auto-probes, configure refresh intervals, and manage probe session cleanup. Mirrors the Claude usage tracking workflow with 24-hour probe budgets and auto-delete options.
Interactive flip cards reveal insights behind every metric. Click any analytics card to see sparklines, agent breakdowns, and detailed context. Switch between Sessions and Messages views with unified toggle across all charts.
- Improved launch loading UX with better progress indicators and analytics gating
- Hardened Claude and Codex probe reliability with robust capture logic
- Refined analytics card layouts with balanced spacing and visual hierarchy
- Better stale data indicators with "Last updated" timestamps
SQLite-backed indexing brings dramatically faster session loading and filtering. Background indexing runs at utility priority, updating only changed session files. No more waiting—browse thousands of sessions instantly.
Visualize your AI coding patterns with comprehensive analytics. Track session trends, compare agent usage, discover your most productive hours with time-of-day heatmaps, and view key metrics—all in a dedicated analytics window.
Deep-dive into the git context of any Codex session. See repository state, branch info, and historical diffs—understand exactly what code changes were visible to Codex during each session. Right-click any Codex session → Show Git Context.
Usage limit tracking and reset times now properly support Codex 0.50+ session format changes. The strip and menu show a "Stale data" warning when rate‑limit information is older than the freshness threshold, even if token‑only events or UI refreshes occurred meanwhile. Flexible timestamp parsing handles both old and new session formats.
Browse Codex CLI, Claude Code, and Gemini CLI sessions side-by-side. Toggle between sources (Both / Codex / Claude / Gemini) with strict filtering and unified search.
One search for everything. Find any snippet or prompt instantly — no matter which agent or project it came from (Codex, Claude, or Gemini CLI).
Smart sorting, instant cancel, full-text search with project filters.
Reopen any Codex or Claude session in Terminal/iTerm with one click — or just copy what you need.
When /resume falls short, browse visually, copy the fragment, and drop it into a new terminal or ChatGPT.
Independent 5-hour and weekly limits for Codex and Claude. A color-coded menu-bar indicator (or in-app strip) shows live percentages and reset times so you never get surprised mid-session.
Visualize your AI coding patterns with comprehensive analytics:
- Session trends: Track daily/weekly session counts and message volume over time
- Agent breakdown: Compare Codex CLI vs Claude Code usage patterns
- Time-of-day heatmap: Discover when you're most productive with AI tools
- Key metrics: Average session length, total messages, and usage distribution
Access via Window → Analytics or the toolbar analytics icon.
Deep-dive into the git context of any Codex session:
- Repository state: See branch, commit, and working tree status at session time
- Historical diffs: Review exact code changes that were visible to Codex
- Context timeline: Understand what git context influenced each session
Right-click any Codex session → Show Git Context to open the inspector.
All processing runs on your Mac.
Reads ~/.codex/sessions, ~/.claude/sessions, Gemini CLI checkpoints under ~/.gemini/tmp, and OpenCode sessions under ~/.local/share/opencode/storage/session (all read‑only).
No cloud uploads or telemetry — read‑only by design.
- Download AgentSessions-2.8.1.dmg
- Drag Agent Sessions.app into Applications.
# install with Homebrew
brew tap jazzyalex/agent-sessions
brew install --cask agent-sessionsAgent Sessions includes Sparkle 2 for automatic updates:
- Background checks: The app checks for updates every 24 hours (customizable in Settings)
- Non-intrusive: Update notifications only appear when the app is in focus (menu bar friendly)
- Secure: All updates are cryptographically signed (EdDSA) and Apple-notarized
- Manual checks: Use Help → Check for Updates… anytime
To manually check for updates:
# Force immediate update check (for testing)
defaults delete com.triada.AgentSessions SULastCheckTime
open "/Applications/Agent Sessions.app"Note: The first Sparkle-enabled release (2.4.0+) requires a manual download. All subsequent updates work automatically via in-app prompts.
