agent-sessions

Name: agent-sessions
Author: jazzyalex

Verified

Local-first macOS app to browse, search, analyze, and resume supported AI coding-agent session history across Codex, Claude Code, OpenCode, Cursor Agent, Hermes, OpenClaw, Copilot CLI, and more.

705stars

45forks

Swift

Installation

# Add to your Claude Code skills
git clone https://github.com/jazzyalex/agent-sessions

Getting Started

Guides for using ai agents skills like agent-sessions.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/13/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-13T06:49:33.429Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is agent-sessions?

agent-sessions is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by jazzyalex. Local-first macOS app to browse, search, analyze, and resume supported AI coding-agent session history across Codex, Claude Code, OpenCode, Cursor Agent, Hermes, OpenClaw, Copilot CLI, and more. It has 705 GitHub stars.

Is agent-sessions safe to use?

Yes. agent-sessions passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install agent-sessions?

Clone the repository with "git clone https://github.com/jazzyalex/agent-sessions" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is agent-sessions written in?

agent-sessions is primarily written in Swift. It is open-source under jazzyalex on GitHub, so you can review or fork the full source.

Are there alternatives to agent-sessions?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agent-sessions against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

xalgorix auto-browser

Agent Sessions (macOS)

Session management for Codex, Claude, OpenCode, Cursor, GitHub Copilot CLI, Pi, Antigravity CLI, Hermes, and OpenClaw on macOS. Search, inspect, save, and resume local AI-coding sessions from CLI tools, desktop apps, and IDE agent surfaces.

Requires: macOS 14+
License: MIT
Security & Privacy: Local-only. No telemetry. Details: docs/PRIVACY.md and docs/security.md

New in 4.3.1 — A rebuilt first-run experience (single-screen setup, a What's New panel, in-app feedback) and one-click Fix for usage tracking: whenever Agent Sessions can't read your Claude or Codex usage, a guided dialog explains what's wrong and walks you through getting it back. See what's new ↓

Overview

Agent 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, Antigravity, GitHub Copilot CLI, and Pi histories into one searchable view, with transcript inspection, image browsing, saved-session recovery, and resume commands for supported CLIs.

Security & Privacy

Local-first: session data stays on your Mac.
No telemetry, analytics, remote logging, advertising identifiers, or session-history uploads.
Reads local session folders you choose, plus supported default CLI locations.
Builds local indexes/databases for search and navigation.
Explicit actions may open Terminal/iTerm2 resume commands or run status/probe cleanup workflows.
The only network activity is optional Sparkle update checks.

Details: docs/PRIVACY.md and docs/security.md.

What's New in 4.3.1

TL;DR - A rebuilt first run and one-click "Fix" for usage tracking. Setup is now a single, focused screen with a What's New panel and in-app feedback; and whenever Agent Sessions can't read your Claude or Codex usage, a Fix button walks you through getting it back.

Highlights: The first-run experience is one clean screen — a live session count, per-agent toggles, and the Quota Meter always in view — plus a What's New panel that surfaces changes when you update and native feedback you can send without leaving the app. When usage tracking can't reach your account (an expired login or a signed-out CLI), every surface — menu bar, cockpit meter, window footer — shows a Fix… button that opens a guided dialog explaining the problem and the solutions to try in order (re-authenticate, then the Web API or CLI-probe fallback, then recheck). Expired Claude no longer reads as a misleading "0%", usage recovers after claude auth login without relaunching, and the Session Runway "+N sessions" overflow now counts hidden idle sessions.

New in 4.3.1:

Rebuilt first run — a single-screen setup, a What's New panel on update, and in-app feedback.
One-click "Fix" for usage tracking — a guided dialog on every usage surface that explains what's wrong and walks through the fixes in order.
Honest usage states — an expired Claude login shows "reconnecting" and then "sign-in needed" instead of a misleading "0%".
Faster recovery — usage returns after claude auth login without relaunching, and the "session expired" prompt now appears in ~90 seconds.
Runway fixes — "+N sessions" overflow counts hidden idle sessions, and the "active burn" countdown no longer lingers after a session goes idle.
Non-ASCII transcripts — sessions with multi-byte content are no longer hidden by a too-strict decode.

Previous release — 4.3: Usage tracking that never cries wolf — real signed-out / expired-token detection, calm degradation, and in-app sign-in remediation. Full history in the changelog.

Core Features

Browse and search Codex CLI, Codex Desktop, and Codex VS Code sessions in one place.
Browse Claude CLI and Claude Desktop sessions with consistent labels and project context.
Browse Cursor Agent transcripts from Cursor's local storage, enriched with Cursor chat metadata when available.
Hermes Agent sessions participate in browsing, search, filtering, analytics, and resume workflows, including current ~/.hermes/state.db storage.
OpenClaw sessions participate in browsing, search, filtering, deleted-session visibility, and resume workflows while ignoring trajectory traces.
Pi CLI sessions now participate in browsing, search, filtering, and resume workflows.
Unified browsing across supported agents, with strict filtering, saved sessions, and a single session list.
Unified Search and Image Browser 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 or Resume for supported CLI sessions, with Terminal.app, iTerm2, and Warp launch targets.
Agent Cockpit is the live command center for active Codex CLI, Claude CLI, and OpenCode CLI iTerm2 sessions, with a compact Quota Meter for always-on Codex and Claude usage visibility, freshness diagnostics, and projected run-out alerts.
Local-only indexing designed for large histories.

Agent Cockpit (Beta)

Agent Cockpit is the live command center for active iTerm2 Codex CLI, Claude CLI, and OpenCode CLI sessions, with shared active/waiting summaries and live Claude usage tracking.

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

Download AgentSessions-4.3.1.dmg
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"