Agent Sessions (macOS)

Unified session browser for Codex CLI/Desktop/VS Code, Claude CLI/Desktop, Hermes CLI, Cursor CLI, Gemini CLI, GitHub Copilot CLI, OpenCode CLI, OpenClaw CLI, and Pi CLI sessions across CLI and desktop surfaces. 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

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.

Security & Privacy

• Local-first: session data stays on your Mac.
• No telemetry, analytics, remote logging, advertising identifiers, or session-history uploads.
• Reads local session folders you choose, plus supported default CLI locations.
• Builds local indexes/databases for search and navigation.
• Explicit actions may open Terminal/iTerm2 resume commands or run status/probe cleanup workflows.
• The only network activity is optional Sparkle update checks.

Details: docs/PRIVACY.md and docs/security.md.

What's New in 3.8

TL;DR - Agent Sessions is expanding beyond CLI-only workflows into a broader session hub, and Pi CLI now joins the supported agent lineup.

Highlights: Agent Sessions now treats CLI and native-app sessions as part of one growing workspace. Codex Desktop and Claude Desktop sessions are easier to identify and filter, archived Codex Desktop sessions are easier to browse, and desktop chat/worktree rows now preserve clearer project context. Hermes CLI is now part of that broader searchable and resumable workspace, and Agent Sessions also adds tier-2 Pi CLI support with local JSONL discovery, browsing, search, Preferences controls, Pi-specific styling, and Resume/Copy Resume commands via pi --session.

Core Features

• Agent Cockpit is the live command center for active Codex CLI, Claude CLI, and OpenCode CLI iTerm2 sessions.
• Browse and search Codex CLI, Codex Desktop, and Codex VS Code sessions in one place.
• Browse Claude CLI and Claude Desktop sessions with consistent labels and project context.
• Hermes CLI sessions participate in browsing, search, filtering, analytics, and resume workflows.
• Pi CLI sessions now participate in browsing, search, filtering, and resume workflows.
• 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.
• Right-click Copy Resume Command for Claude CLI, Codex CLI, OpenCode CLI, GitHub Copilot CLI, and Gemini CLI sessions.
• Local-only indexing designed for large histories.

Agent Cockpit (Beta)

Agent Cockpit is the live command center for active iTerm2 Codex CLI, Claude CLI, and OpenCode CLI sessions, with shared active/waiting summaries and live Claude usage tracking.

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

Install

Option A — Download DMG

1. Download AgentSessions-3.8.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"

Documentation

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

Resume Workflows

• Right-click any Claude CLI, Codex CLI, Cursor CLI, OpenCode CLI, GitHub Copilot CLI, or Gemini CLI session and choose Copy Resume Command to get the exact CLI command for that session.
• Open a session in your preferred terminal (Terminal.app or iTerm).
• 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
  • ~/.cursor/projects and ~/.cursor/chats
  • ~/.factory/sessions and ~/.factory/projects
  • ~/.local/share/opencode/opencode.db and ~/.local/share/opencode/storage/session
• Details: docs/PRIVACY.md and docs/security.md

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.