{"id":31727196,"url":"https://github.com/jazzyalex/agent-sessions","last_synced_at":"2026-05-29T05:01:22.682Z","repository":{"id":316138640,"uuid":"1060421643","full_name":"jazzyalex/agent-sessions","owner":"jazzyalex","description":"Session browser + Agent Cockpit +  Analytics + Limits tracker for Codex CLI/Desktop/VSC,  Claude Code CLI/Desktop,  OpenCode CLI, Gemini CLI, Pi CLI , GitHub Copilot CLI + OpenClaw \u0026 Hermes agents. Search/filter ALL past sessions,  archive sessions, resume instantly, see rate limits in real-time. Native macOS app.","archived":false,"fork":false,"pushed_at":"2026-05-21T19:29:28.000Z","size":201491,"stargazers_count":566,"open_issues_count":2,"forks_count":34,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-22T04:38:58.725Z","etag":null,"topics":["agentic-workflow","agents","ai","antrophic","claude-code","codex","codex-cli","developer-tools","gpt-5","indie-hacker","macos","openai","orchestrator","productivity-tools","session-management","usage-tracking","vibe-coding"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jazzyalex.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"agents.md","dco":null,"cla":null},"funding":{"github":"jazzyalex","buy_me_a_coffee":"jazzyalexd"}},"created_at":"2025-09-19T22:15:22.000Z","updated_at":"2026-05-21T19:29:33.000Z","dependencies_parsed_at":"2025-10-07T09:14:59.877Z","dependency_job_id":"5e519446-79ec-405c-8787-f1975e3b889c","html_url":"https://github.com/jazzyalex/agent-sessions","commit_stats":null,"previous_names":["jazzyalex/agent-sessions"],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/jazzyalex/agent-sessions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jazzyalex%2Fagent-sessions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jazzyalex%2Fagent-sessions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jazzyalex%2Fagent-sessions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jazzyalex%2Fagent-sessions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jazzyalex","download_url":"https://codeload.github.com/jazzyalex/agent-sessions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jazzyalex%2Fagent-sessions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33637485,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-workflow","agents","ai","antrophic","claude-code","codex","codex-cli","developer-tools","gpt-5","indie-hacker","macos","openai","orchestrator","productivity-tools","session-management","usage-tracking","vibe-coding"],"created_at":"2025-10-09T06:19:07.507Z","updated_at":"2026-05-29T05:01:22.665Z","avatar_url":"https://github.com/jazzyalex.png","language":"Swift","funding_links":["https://github.com/sponsors/jazzyalex","https://buymeacoffee.com/jazzyalexd"],"categories":["Workspaces and User Interfaces","Browser-extensions","Ecosystem","Development Tools \u0026 Utilities","Skills \u0026 Plugins","Tools","Productivity Tools"],"sub_categories":["GateGuard — Fact-Forcing PreToolUse Gate","Notable Skills \u0026 Plugins","Session manager","Desktop Applications \u0026 GUI Tools"],"readme":"# Agent Sessions (macOS)\n\n[![Build](https://github.com/jazzyalex/agent-sessions/actions/workflows/ci.yml/badge.svg)](https://github.com/jazzyalex/agent-sessions/actions/workflows/ci.yml)\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"100\" align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/app-icon-512.png\" alt=\"App Icon\" width=\"80\" height=\"80\"/\u003e\n\u003c/td\u003e\n\u003ctd\u003e\n\n**Session management for [Codex](docs/guides/codex-local-history.html), [Claude](docs/guides/claude-code-jsonl-history.html), [OpenCode](docs/guides/opencode-sqlite-history.html), [Cursor](docs/guides/cursor-agent-local-history.html), GitHub Copilot CLI, Pi, Gemini CLI, [Hermes](docs/guides/hermes-agent-state-db-history.html), and [OpenClaw](docs/guides/openclaw-local-agent-history.html) on macOS.**\nSearch, inspect, save, and resume local AI-coding sessions from CLI tools, desktop apps, and IDE agent surfaces.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n- Requires: macOS 14+\n- License: MIT\n- Security \u0026 Privacy: Local-only. No telemetry. Details: `docs/PRIVACY.md` and `docs/security.md`\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/jazzyalex/agent-sessions/releases/download/v3.8.2/AgentSessions-3.8.2.dmg\"\u003e\u003cb\u003eDownload Agent Sessions 3.8.2 (DMG)\u003c/b\u003e\u003c/a\u003e\n  •\n  \u003ca href=\"https://github.com/jazzyalex/agent-sessions/releases\"\u003eAll Releases\u003c/a\u003e\n  •\n  \u003ca href=\"#install\"\u003eInstall\u003c/a\u003e\n  •\n  \u003ca href=\"#resume-workflows\"\u003eResume Workflows\u003c/a\u003e\n  •\n  \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e\n\u003c/p\u003e\n\n## Overview\n\nAgent Sessions is a local-first Mac app for finding useful work that coding agents already wrote to disk. It brings Codex, Claude, OpenCode, Cursor Agent, Hermes, OpenClaw, Gemini CLI, GitHub Copilot CLI, and Pi histories into one searchable view, with transcript inspection, image browsing, saved-session recovery, and resume commands for supported CLIs.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp style=\"margin:0 0 0px 0;\"\u003e\u003cem\u003eSessions search with transcript and image preview\u003c/em\u003e\u003c/p\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/assets/session-all-agents-dark.png\"\u003e\n    \u003cimg src=\"docs/assets/session-history-light.png\" alt=\"Main Sessions window with local agent history and transcript preview\" width=\"100%\" style=\"max-width:960px;border-radius:8px;margin:5px 0;\"/\u003e\n  \u003c/picture\u003e\n\n  \u003cp style=\"margin:0 0 0px 0;\"\u003e\u003cem\u003eSaved Sessions with restore actions\u003c/em\u003e\u003c/p\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/assets/saved-sessions-dark.png\"\u003e\n    \u003cimg src=\"docs/assets/screenshot-V.png\" alt=\"Saved Sessions window listing stored sessions and restore actions\" width=\"100%\" style=\"max-width:960px;border-radius:8px;margin:5px 0;\"/\u003e\n  \u003c/picture\u003e\n\n  \u003cp style=\"margin:0 0 0px 0;\"\u003e\u003cem\u003eImage Browser for visual session outputs\u003c/em\u003e\u003c/p\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/assets/image-browser-dark.png\"\u003e\n    \u003cimg src=\"docs/assets/image-browser-light.png\" alt=\"Image Browser window with thumbnail grid and selected screenshot preview\" width=\"100%\" style=\"max-width:960px;border-radius:8px;margin:5px 0;\"/\u003e\n  \u003c/picture\u003e\n\u003c/div\u003e\n\n## Security \u0026 Privacy\n\n- Local-first: session data stays on your Mac.\n- No telemetry, analytics, remote logging, advertising identifiers, or session-history uploads.\n- Reads local session folders you choose, plus supported default CLI locations.\n- Builds local indexes/databases for search and navigation.\n- Explicit actions may open Terminal/iTerm2 resume commands or run status/probe cleanup workflows.\n- The only network activity is optional Sparkle update checks.\n\nDetails: `docs/PRIVACY.md` and `docs/security.md`.\n\n## What's New in 3.8.1\n\n**TL;DR** - Resume workflows now support Warp across every supported CLI agent.\n\n**Highlights:** Choose Terminal.app, iTerm2, or Warp once in Preferences, and Agent Sessions uses that shared terminal preference for supported Resume launches. Warp launches use terminal tab configs so Claude, Codex, Cursor, Gemini, GitHub Copilot, Hermes, OpenCode, and Pi Resume commands open in the intended terminal tab.\n\n## Core Features\n\n- Browse and search [Codex CLI, Codex Desktop, and Codex VS Code sessions](docs/guides/codex-local-history.html) in one place.\n- Browse [Claude CLI and Claude Desktop sessions](docs/guides/claude-code-jsonl-history.html) with consistent labels and project context.\n- Browse [Cursor Agent transcripts](docs/guides/cursor-agent-local-history.html) from Cursor's local storage, enriched with Cursor chat metadata when available.\n- [Hermes Agent sessions](docs/guides/hermes-agent-state-db-history.html) participate in browsing, search, filtering, analytics, and resume workflows, including current `~/.hermes/state.db` storage.\n- [OpenClaw sessions](docs/guides/openclaw-local-agent-history.html) participate in browsing, search, filtering, deleted-session visibility, and resume workflows while ignoring trajectory traces.\n- Pi CLI sessions now participate in browsing, search, filtering, and resume workflows.\n- Unified browsing across supported agents, with strict filtering, saved sessions, and a single session list.\n- Unified Search and Image Browser across sessions, plus in-session Find for fast transcript navigation.\n- Readable tool calls/outputs and navigation between prompts, tools, and errors.\n- Right-click Copy Resume Command or Resume for supported CLI sessions, with Terminal.app, iTerm2, and Warp launch targets.\n- Agent Cockpit is the live command center for active Codex CLI, Claude CLI, and OpenCode CLI iTerm2 sessions.\n- Local-only indexing designed for large histories.\n\n## Agent Cockpit (Beta)\n\nAgent Cockpit is the live command center for active iTerm2 [Codex CLI](docs/guides/codex-local-history.html), [Claude CLI](docs/guides/claude-code-jsonl-history.html), and [OpenCode CLI](docs/guides/opencode-sqlite-history.html) sessions, with shared active/waiting summaries and live Claude usage tracking.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp style=\"margin:0 0 0px 0;\"\u003e\u003cem\u003eAgent Cockpit\u003c/em\u003e\u003c/p\u003e\n  \u003cimg src=\"docs/assets/screenshot-cockpit-light.png\" alt=\"Compact cockpit menu showing grouped active sessions in Light Mode\" width=\"100%\" style=\"max-width:820px;border-radius:8px;margin:5px 0;\"/\u003e\n\u003c/div\u003e\n\n## Agent Cockpit Setup\n\n### Prerequisites\n\n- Agent Sessions with Live Sessions enabled\n- iTerm2\n- Agents running in iTerm2\n\n### Ideal Setup\n\n- Set the iTerm window title to the repo name\n- Run that repo's agents in that window\n- Give each tab/session its own clear name\n- Use the same name for the tab, session, and badge\n\n### Layout\n\n- One repo per desktop/Space if possible\n- Or keep several on one desktop if you prefer\n- Keep Agent Cockpit pinned in a corner so you can always see activity\n- Click from the cockpit to jump straight to a session\n\n## Install\n\n### Option A — Download DMG\n1. [Download AgentSessions-3.8.2.dmg](https://github.com/jazzyalex/agent-sessions/releases/download/v3.8.2/AgentSessions-3.8.2.dmg)\n2. Drag **Agent Sessions.app** into Applications.\n\n### Option B — Homebrew\n```bash\nbrew tap jazzyalex/agent-sessions\nbrew install --cask agent-sessions\n```\n\n### Automatic Updates (Sparkle)\n\nAgent Sessions uses Sparkle for automatic updates (signed + notarized).\n\nTo force an update check (for testing):\n```bash\ndefaults delete com.triada.AgentSessions SULastCheckTime\nopen \"/Applications/Agent Sessions.app\"\n```\n\n## Documentation\n\n- Guides:\n  - [Codex local history: search Codex CLI, Desktop, and VS Code sessions](docs/guides/codex-local-history.html)\n  - [OpenCode SQLite history: browsing old runs](docs/guides/opencode-sqlite-history.html)\n  - [Claude Code JSONL history: what you can recover locally](docs/guides/claude-code-jsonl-history.html)\n  - [Cursor Agent local history: search Cursor Agent transcripts](docs/guides/cursor-agent-local-history.html)\n  - [Hermes Agent state database history](docs/guides/hermes-agent-state-db-history.html)\n  - [OpenClaw local agent history](docs/guides/openclaw-local-agent-history.html)\n- Release notes: `docs/CHANGELOG.md`\n- Monthly summaries: `docs/summaries/`\n- Privacy: `docs/PRIVACY.md`\n- Security: `docs/security.md`\n- Maintainers: `docs/deployment.md`\n\n## Resume Workflows\n\n- Right-click any supported CLI session and choose **Copy Resume Command** to get the exact CLI command for that session.\n- Open supported Resume sessions in your preferred terminal: Terminal.app, iTerm2, or Warp.\n- Use Unified Search (across sessions) and Find (within a session) to jump to relevant tool calls and outputs quickly.\n\n## Privacy \u0026 Security\n\n- Local-only. No telemetry.\n- Reads agent session directories in read-only mode:\n  - `~/.codex/sessions`\n  - `~/.claude/projects`\n  - `~/.gemini/tmp`\n  - `~/.copilot/session-state`\n  - `~/.cursor/projects` and `~/.cursor/chats`\n  - `~/.factory/sessions` and `~/.factory/projects`\n  - `~/.hermes/state.db` and `~/.hermes/sessions`\n  - `~/.openclaw/agents` and legacy `~/.clawdbot/agents`\n  - `~/.pi/agent/sessions`\n  - `~/.local/share/opencode/opencode.db` and `~/.local/share/opencode/storage/session`\n- Details: `docs/PRIVACY.md` and `docs/security.md`\n\n## Development\n\nPrerequisites:\n- Xcode (macOS 14+)\n\nBuild:\n```bash\nxcodebuild -project AgentSessions.xcodeproj -scheme AgentSessions -configuration Debug -destination 'platform=macOS' build\n```\n\nTests:\n```bash\nxcodebuild -project AgentSessions.xcodeproj -scheme AgentSessionsTests -destination 'platform=macOS' test\n```\n\nContributing:\n- `CONTRIBUTING.md`\n\n## License\n\nMIT. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjazzyalex%2Fagent-sessions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjazzyalex%2Fagent-sessions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjazzyalex%2Fagent-sessions/lists"}