Agent Sessions app icon

Agent Sessions

• macOS • Open Source •

Session Management for Codex, Claude, OpenCode, Cursor, Copilot, Pi and Gemini

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.

local histories, desktop transcripts, resume-ready workflows.

Download Agent Sessions 3.9.1 View on GitHub Follow on X

What's New in 3.9

The new 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. 3.9 also adds shared limit notifications, 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.

Install with Homebrew Tap

brew tap jazzyalex/agent-sessions
brew install --cask agent-sessions

Sessions search with transcript preview

Main Sessions window with local agent history and transcript preview

Session History Across Agents

Browse local sessions from CLI tools, desktop apps, and app-bundled coding agents in one unified window.

  • Codex CLI
  • Claude CLI
  • Hermes Agent
  • Pi CLI
  • Cursor Agent
  • Gemini CLI
  • GitHub Copilot CLI
  • OpenCode
  • OpenClaw

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.

Unified Search & Images

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.

Local & Private

  • All processing on Mac
  • Reads local session storage
  • No cloud uploads or telemetry
  • Read-only by design

Limits Widget and Agent Cockpit

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. Agent Cockpit still provides grouped active and waiting visibility, quick focus jumps, and compact/full cockpit modes.

Limits Widget

Small Limits Widget showing Codex and Claude 5h and weekly usage
Compact cockpit menu showing grouped active sessions in Light Mode Compact cockpit menu showing grouped active sessions in Dark Mode

Resume Any Session

Right-click a supported CLI session to copy the exact resume command or open it directly in Terminal.app, iTerm2, or Warp.

Saved Sessions

Saved Sessions window for managing archived sessions. Delete, reveal, and diagnose with archive status tooltips.

Usage Tracking

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 or exhausted.

Analytics

Interactive flip cards with sparklines and insights. Session trends, agent breakdowns, and time-of-day heatmaps.

Local History Guides

Codex local history

How Agent Sessions searches Codex CLI, Codex Desktop, and Codex VS Code rollout history from ~/.codex/sessions.

OpenCode SQLite history

Where OpenCode stores local session data, what Agent Sessions reads, and how to browse/search old OpenCode runs locally.

Claude Code JSONL history

What Claude Code writes to local JSONL transcripts, what transcript context can be recovered, and where the boundary is.

Cursor Agent local history

How Agent Sessions reads Cursor Agent transcripts from Cursor's local storage without claiming full Cursor IDE chat history.

Hermes state.db history

How Hermes Agent sessions in ~/.hermes/state.db become searchable local project history.

OpenClaw local history

How OpenClaw JSONL sessions are discovered, searched, and kept separate from trajectory traces.

Saved Sessions with restore actions

Saved Sessions window listing stored sessions and restore actions

Image Browser for visual session outputs

Image Browser window with thumbnail grid and selected screenshot preview

Menu bar status strip

Agent Sessions menu bar status label

Analytics dashboard filtered to one project

Analytics dashboard filtered to one project