agent-sessions

agent-sessions

Session browser + Agents Analytics + Limits tracker for Codex CLI, Claude Code, OpenCode, Gemini CLI, Factory Droid & GitHub Copilot CLI. Search ALL past sessions, filter by folder·repo, resume instantly, see rate limits in real-time. Native macOS app.

Stars: 239

Visit
 screenshot

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. 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. Core features include unified browsing across supported agents, unified search across all sessions, readable tool calls/outputs, and local-only indexing designed for large histories.

README:

Agent Sessions (macOS)

Build

App Icon

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.11.1 (DMG)All ReleasesInstallResume WorkflowsDevelopment

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)

Transcript view with search (Dark Mode)

Resume Codex CLI and Claude Code sessions

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.11.1.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.11

Short version:

  • Major update: Added OpenClaw (clawdbot) session support, with Advanced visibility for deleted sessions.
  • Major update: Expanded Images workflows with inline thumbnails in Session view and a faster, richer Image Browser.
  • Major bug fix: Search coverage for some sessions is now more complete via incremental backfill and changed-file indexing.
  • Major bug fix: Reduced Energy Warning spikes by replacing always-on idle work with activation/event-driven refresh and power-aware indexing/probing.
  • OpenClaw transcript handling is cleaner, including better media-hint suppression and improved tool output formatting.
  • Image Browser now includes Project/Agent filters, cached indexing, and richer image actions.

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.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for agent-sessions

Similar Open Source Tools

For similar tasks

For similar jobs