https://github.com/jazzyalex/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.
https://github.com/jazzyalex/agent-sessions
agentic-workflow agents ai antrophic claude-code codex codex-cli developer-tools gpt-5 indie-hacker macos openai productivity-tools session-management usage-tracking vibe-coding
Last synced: about 1 month ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/jazzyalex/agent-sessions
- Owner: jazzyalex
- License: mit
- Created: 2025-09-19T22:15:22.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-25T04:07:50.000Z (about 2 months ago)
- Last Synced: 2026-01-25T11:09:14.740Z (about 2 months ago)
- Topics: agentic-workflow, agents, ai, antrophic, claude-code, codex, codex-cli, developer-tools, gpt-5, indie-hacker, macos, openai, productivity-tools, session-management, usage-tracking, vibe-coding
- Language: Swift
- Homepage:
- Size: 54.3 MB
- Stars: 221
- Watchers: 0
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Security: docs/security.md
- Agents: agents.md
Awesome Lists containing this project
- awesome-ChatGPT-repositories - agent-sessions - ⭐ 302 / 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. (Browser-extensions)
- awesome-codex-cli - agent-sessions - Session browser + usage tracker for Codex CLI and Claude Code. Search ALL past sessions, filter by folder·repo, resume instantly (Tools / Session manager)
README
# Agent Sessions (macOS)
[](https://github.com/jazzyalex/agent-sessions/actions/workflows/ci.yml)
**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 (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.11.dmg](https://github.com/jazzyalex/agent-sessions/releases/download/v2.11/AgentSessions-2.11.dmg)
2. Drag **Agent Sessions.app** into Applications.
### Option B — Homebrew
```bash
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):
```bash
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:
```bash
xcodebuild -project AgentSessions.xcodeproj -scheme AgentSessions -configuration Debug -destination 'platform=macOS' build
```
Tests:
```bash
xcodebuild -project AgentSessions.xcodeproj -scheme AgentSessionsTests -destination 'platform=macOS' test
```
Contributing:
- `CONTRIBUTING.md`
## License
MIT. See `LICENSE`.