Agent Sessions (macOS)

Unified session browser for Codex CLI, Claude Code, and Gemini CLI (read‑only). Search, browse, and resume any past AI-coding session in a single local-first macOS app.

Download Agent Sessions 2.4 (DMG) • All Releases • Install • Resume Workflows

Overview

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

---

What's New in 2.3

• Gemini CLI:
  • Indexes ~/.gemini/tmp/**/session-*.json (and common variants)
  • Lists and opens transcripts in the existing viewer (no writes, no resume)
  • Unified search and source toggle alongside Codex/Claude
• Favorites (★):
  • Inline star on each row + context menu Add/Remove
  • Toolbar “Favorites” toggle filters list (AND with search)
  • Persisted in UserDefaults; zero schema changes
• UI polish and fixes:
  • Transcript vs Terminal parity across providers
  • Persistent window/split positions; toolbar spacing adjustments
  • “Refresh preview” affordance for stale Gemini files

Core Features

Unified Interface v2

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.

Unified Search v2

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.

Instant Resume & Re-use

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.

Dual Usage Tracking

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.

Local, Private & Safe

All processing runs on your Mac.
Reads ~/.codex/sessions, ~/.claude/sessions, and Gemini CLI checkpoints under ~/.gemini/tmp (read‑only).
No cloud uploads or telemetry — read‑only by design.

---

Install

Option A — Download DMG

1. Download AgentSessions-2.4.dmg
2. Drag Agent Sessions.app into Applications.

Option B — Homebrew Tap

# install with Homebrew
brew tap jazzyalex/agent-sessions
brew install --cask agent-sessions

Automatic Updates

Agent 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.