Thanks to visit codestin.com
Credit goes to Github.com

Skip to content

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

License

Notifications You must be signed in to change notification settings

jazzyalex/agent-sessions

Repository files navigation

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.12 (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.12.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.12

Short version:

  • Major update: Transcript rendering now recognizes semantic plans/code/diffs/review cards and improves file-link behavior for faster navigation.
  • Major update: Added crash diagnostics controls in Preferences with local queueing plus explicit email/export reporting workflows.
  • Major bug fix: Live transcript refresh/render paths are more stable during rapid updates, mode switches, and table/list churn.
  • Major bug fix: Focused-session monitoring is now consistent across supported agents with source-aware cadence and better window-focus handling.
  • Codex usage tracking now keeps token usage fresher by continuing JSONL parsing while selecting preferred rate-limit streams.
  • OpenClaw parsing is more resilient with normalized tool-call/result variants and improved tool-result error classification.

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.

About

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

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published

Contributors 3

  •  
  •  
  •