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: 17 days 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 (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-25T04:07:50.000Z (3 months ago)
- Last Synced: 2026-01-25T11:09:14.740Z (3 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, Cursor, 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.6 (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, Claude Code, and OpenCode sessions
## What's New in 3.6
**TL;DR** — Cursor IDE/CLI joins as the 8th session provider, plus automatic new-provider detection.
**Highlights:** Browse, search, and resume your Cursor AI sessions alongside every other agent. Agent Sessions now reads Cursor's JSONL transcripts and SQLite chat databases from `~/.cursor/`, with full support for subagent hierarchy. A new discoverability banner appears when a newly supported agent is found on disk, and the update tour auto-generates a slide so you never miss a new provider.
## 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.
- Right-click Copy Resume Command for Claude, Codex, OpenCode, Copilot, and Gemini sessions.
- Local-only indexing designed for large histories.
## Agent Cockpit (Beta)
Agent Cockpit is the live command center for active iTerm2 Codex CLI, Claude Code, and OpenCode sessions, with shared active/waiting summaries and live Claude usage tracking.
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
## Install
### Option A — Download DMG
1. [Download AgentSessions-3.6.dmg](https://github.com/jazzyalex/agent-sessions/releases/download/v3.6/AgentSessions-3.6.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"
```
## 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, Codex, Cursor, OpenCode, Copilot, or Gemini 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:
```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`.