Skip to content
 
 

Latest commit

 

History

2,282 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent Sessions for macOS

Build

Find the agent session you need

Search local conversations from Codex, Claude Code, Cursor, and 12 other coding agents in one Mac app. Read the transcript, find supported image outputs, and resume supported CLI sessions. For Codex and Claude, see which sessions are burning through your quota.

Open source. Your session history stays on your Mac. No telemetry.

Download Agent Sessions 5.2 · See the product page · All releases

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

Agent Sessions showing searchable local coding-agent sessions and a floating Codex and Claude Quota Meter

Search 15 local agent histories, resume supported sessions, and track Codex and Claude quota burn.

What it does

  • Find past work. Search prompts, responses, tool calls, command output, errors, file paths, and supported image references across local agent histories.
  • Pick up where you left off. Copy a resume command or open a supported CLI session in Terminal.app, iTerm2, or Warp.
  • See which session is burning your quota. Track live per-session Codex and Claude burn against 5-hour and weekly windows; switch between quota, tokens, and estimated API-equivalent cost.
  • Keep transcripts on your Mac. Agent Sessions builds its search index locally and does not upload session history.

What's New in 5.2

  • Agent Sessions is now available in English and Simplified Chinese, with an in-app invitation for established users to help add another language.
  • Quota Meter weekly rates use stricter, recent evidence; Astra and Sol long-context pricing are included, and uncertain inputs fail closed.
  • Session-list invitations wait for every enabled source to settle, respect dismissal consistently, and avoid repeating or rotating too quickly.

Supported sources

Agent Sessions reads 14 active agent formats plus legacy Droid sessions. Capabilities differ by source and installed CLI version.

Source Browse and search Resume
Codex Yes Supported sessions
Claude Code Yes Supported sessions
Cursor Yes Supported sessions
GitHub Copilot CLI Yes Supported sessions
OpenCode Yes Supported sessions
Antigravity Yes Supported sessions
Pi Yes Supported sessions
Kimi Code Yes Supported sessions
Grok CLI Yes Supported sessions
Hermes Yes Supported sessions
OpenClaw Yes No
Qwen Code Yes Active sessions; end-to-end unverified
Devin CLI Yes Supported active sessions
fx Yes Command plan tested; interactive reopen unverified
Droid Legacy sessions No active monitoring

Format-maintenance owners, verification dates, and tested versions are in STEWARDS.md. Session-Bench compares ten agents across 20 evidence-backed format gates.

Quota Meter

An account meter can tell you that 60% is used. Agent Sessions shows which active Codex or Claude session is spending it.

  • Per-session burn against available 5-hour and weekly windows.
  • Four views: 5-hour, weekly, tokens per hour, and estimated API-equivalent dollars per hour.
  • Per-model pricing when one session uses more than one model.
  • Explicit unavailable states when a provider does not expose a usable limit.

The dollar view is an API-equivalent estimate, not your subscription bill.

Quota Meter showing weekly burn rates for active Codex sessions and a Claude session

Install

Download AgentSessions-5.2.dmg, open it, and drag Agent Sessions.app into Applications.

Or use Homebrew:

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

Updates are signed, notarized, and delivered through Sparkle.

Local-history guides

See the changelog, privacy policy, and security notes.

Privacy and network access

  • Transcript discovery, parsing, indexing, search, and navigation happen locally.
  • Agent session folders are read rather than rewritten.
  • Explicit actions can open resume commands or manage saved copies.
  • Optional network access checks for signed Sparkle updates and fetches a public model-price list. Neither request contains transcript data.

Contributing

Missing your agent? Use the new source form. You can contribute a sanitized fixture without writing Swift, adopt an existing format as a steward, or follow the contribution guide.

Build locally with Xcode 16 or later:

xcodebuild -project AgentSessions.xcodeproj -scheme AgentSessions -configuration Debug -destination 'platform=macOS' build

Run the stable test wrapper:

./scripts/xcode_test_stable.sh

Found a session you thought you had lost? Star Agent Sessions to help other developers find it.

License

MIT. See LICENSE.

About

Local-first macOS app to browse, search, analyze, and resume supported AI coding-agent session history across Codex, Claude Code, OpenCode, Cursor Agent, Antigravity, Hermes, OpenClaw, Copilot CLI, and more.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages