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

Agent Cockpit (Beta)

Agent Cockpit is the 3.2 live command center for active iTerm2 Codex CLI, Claude Code, and OpenCode sessions, with shared active/waiting summaries and steadier OpenCode live-state detection.

Agent Cockpit

Agent Cockpit Setup

Prerequisites

• Agent Sessions with Live Sessions enabled
• iTerm2
• Agents running in iTerm2

Ideal Setup

• Set the iTerm window title to the repo name
• Run that repo's agents in that window
• Give each tab/session its own clear name
• Use the same name for the tab, session, and badge

Layout

• One repo per desktop/Space if possible
• Or keep several on one desktop if you prefer
• Keep Agent Cockpit pinned in a corner so you can always see activity
• Click from the cockpit to jump straight to a session

Core Features

• Agent Cockpit live HUD for active Codex CLI, Claude Code, and OpenCode iTerm2 sessions.
• Unified browsing across supported agents, with strict filtering and a single session list.
• Unified Search and image browsing across 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-3.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/opencode.db and ~/.local/share/opencode/storage/session
• Details: docs/PRIVACY.md and docs/security.md

---

What's New in 3.2

TL;DR:

• Agent Cockpit now includes OpenCode in the same live active/waiting HUD and menu bar summaries used for Codex and Claude.
• OpenCode v1.2+ sessions now load from the new SQLite backend automatically, while legacy JSON storage remains supported.
• OpenCode live dots, busy-state detection, and SQLite-backed search hydration were tightened for a cleaner 3.2 release.

Highlights:

• Agent Cockpit and the menu bar now surface OpenCode sessions in shared active/waiting counts and quick live-session summaries.
• OpenCode storage detection now auto-selects SQLite when ~/.local/share/opencode/opencode.db is present and falls back to legacy per-session JSON files otherwise.
• Main-window OpenCode live dots now stay visible more reliably, and iTerm busy-state heuristics are less likely to show active sessions as idle.
• SQLite-backed OpenCode sessions now hydrate correctly in search, direct session-directory overrides work again, and large raw JSON previews are safely truncated.

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.