https://github.com/jazzyalex/agent-sessions

Session browser + usage tracker for Codex CLI and Claude Code. 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: 14 days ago
JSON representation

Session browser + usage tracker for Codex CLI and Claude Code. 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
• Created: 2025-09-19T22:15:22.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2025-10-07T07:20:38.000Z (16 days ago)
• Last Synced: 2025-10-07T09:29:07.198Z (15 days 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: 16.9 MB
• Stars: 8
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Agents: agents.md

Awesome Lists containing this project

• 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)

[![Build](https://github.com/jazzyalex/agent-sessions/actions/workflows/ci.yml/badge.svg)](https://github.com/jazzyalex/agent-sessions/actions/workflows/ci.yml)

> **Unified session browser for Codex CLI and Claude Code.**  

> Search, browse, and resume any past AI-coding session in a single local-first macOS app.



  





  Download Agent Sessions 2.2 (DMG)

  •

  All Releases

  •

  Install

  •

  Resume Workflows



---

## ✨ Overview

Agent Sessions 2 brings **Codex CLI** and **Claude Code** together in one interface.  

Look up any past session — even the ancient ones `/resume` can’t show — or browse visually to find that perfect prompt or code snippet, then instantly copy or resume it.

**Local-first, open source, and built for terminal vibe warriors.**



  

  
Session browser with grouped timeline and full-text search

  

  
Transcript view with timestamps and role-based styling

  

  
Menu-bar indicator showing 5-hour and weekly usage percentages



---

## 🔧 Core Features

### Unified Interface v2

Browse **Codex CLI** and **Claude Code** sessions side-by-side. Toggle between Both / Codex / Claude sources with strict filtering and unified search.

### Unified Search v2

One search for everything. Find any snippet or prompt instantly — no matter which agent or project it came from.  

Smart sorting, instant cancel, full-text search with project filters.

### Instant Resume & Re-use

Reopen any Codex or Claude session in Terminal/iTerm with one click — or just copy what you need.  

When `/resume` falls short, browse visually, copy the fragment, and drop it into a new terminal or ChatGPT.

### Dual Usage Tracking

Independent 5-hour and weekly limits for Codex and Claude.  

A color-coded **menu-bar indicator** (or in-app strip) shows live percentages and reset times so you never get surprised mid-session.

### Local, Private & Safe

All processing runs on your Mac.  

Reads `~/.codex/sessions` and `~/.claude/sessions` locally.  

No cloud uploads or telemetry — **read-only by design.**

---

## 💻 Install

### Option A — Download DMG

1. [Download AgentSessions-2.2.dmg](https://github.com/jazzyalex/agent-sessions/releases/download/v2.2/AgentSessions-2.2.dmg)  

2. Drag **Agent Sessions.app** into Applications.

### Option B — Homebrew Tap

```bash

# install with Homebrew

brew tap jazzyalex/agent-sessions

brew install --cask agent-sessions