Agent Sessions (macOS)

Unified session browser for Codex CLI, Claude Code, Gemini CLI, GitHub Copilot CLI, Droid (Factory CLI), and OpenCode. Search, browse, and resume your past AI-coding sessions in a local-first macOS app.

• Requires: macOS 14+
• License: MIT
• Security & Privacy: Local-only. No telemetry. Details: docs/PRIVACY.md and docs/security.md

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

Overview

Agent Sessions helps you search across large session histories, quickly find the right prompt/tool output, then reuse it by copying snippets or resuming supported sessions in your terminal.

Transcript view with search (Dark Mode)

Resume Codex CLI and Claude Code sessions

Core Features

• Unified browsing across supported agents, with strict filtering and a single session list.
• Unified Search across all sessions plus in-session Find for fast transcript navigation.
• Readable tool calls/outputs and navigation between prompts, tools, and errors.
• Local-only indexing designed for large histories.

Documentation

• Release notes: docs/CHANGELOG.md
• Monthly summaries: docs/summaries/
• Privacy: docs/PRIVACY.md
• Security: docs/security.md
• Maintainers: docs/deployment.md

Install

Option A — Download DMG

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

Option B — Homebrew

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

Automatic Updates (Sparkle)

Agent Sessions uses Sparkle for automatic updates (signed + notarized).

To force an update check (for testing):

defaults delete com.triada.AgentSessions SULastCheckTime
open "/Applications/Agent Sessions.app"

Resume Workflows

• Open a session in your preferred terminal (Terminal.app or iTerm).
• Copy a session ID, command, or snippet to reuse in a new run.
• Use Unified Search (across sessions) and Find (within a session) to jump to relevant tool calls and outputs quickly.

Privacy & Security

• Local-only. No telemetry.
• Reads agent session directories in read-only mode:
  • ~/.codex/sessions
  • ~/.claude/sessions
  • ~/.gemini/tmp
  • ~/.copilot/session-state
  • ~/.factory/sessions and ~/.factory/projects
  • ~/.local/share/opencode/storage/session
• Details: docs/PRIVACY.md and docs/security.md

---

What's New in 2.10

Short version:

• Apple Notes-style Unified Search across all sessions and inside a session, compatible with filters.
• SQLite-backed search plus richer instant indexing for faster results and better recall.
• Incremental analytics refresh and faster startup with immediate hydrated lists.
• Session view (formerly Color view) is now a colored timeline with improved formatting.
• Unified Search navigation and local Find are more consistent and responsive.
• Cockpit-style status UI and refreshed session list typography with live counts.
• Onboarding tour refreshed and always shows supported agents.

Details: docs/CHANGELOG.md and docs/summaries/.

Development

Prerequisites:

• Xcode (macOS 14+)

Build:

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

Tests:

xcodebuild -project AgentSessions.xcodeproj -scheme AgentSessionsTests -destination 'platform=macOS' test

Contributing:

• CONTRIBUTING.md

License

MIT. See LICENSE.