Agent Sessions

Name: Agent Sessions
Author: vladmdgolam

vladmdgolam/agent-skills

13 installs
7 repo stars
Updated July 30, 2026
vladmdgolam/agent-skills

Helps with ai & agent building tasks.

About

agent-sessions is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.

agent-sessions
AI & Agent Building
AI-coding skill

Agent Sessions by the numbers

13 all-time installs (skills.sh)
+1 installs in the week ending Aug 5, 2026 (Skillselion tracking)
Ranked #11,409 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/vladmdgolam/agent-skills --skill agent-sessions

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/vladmdgolam/agent-skills/agent-sessions.svg)](https://skillselion.com/skills/vladmdgolam/agent-skills/agent-sessions)

Installs	13
repo stars	★ 7
Last updated	July 30, 2026
Repository	vladmdgolam/agent-skills ↗

What it does

Helps with ai & agent building tasks.

Files

SKILL.mdMarkdownGitHub ↗

Agent Sessions

Search and manage AI coding agent conversation history across Claude Code, Codex CLI, Gemini CLI, opencode, and Hermes Agent.

$ARGUMENTS

Tools Available

CLI: `agent-sessions`

Located at /Users/vladmdgolam/Play/radar/tools/agent-sessions. A Python 3 script that reads session data from all supported agents.

# List all recent sessions (default 30)
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions

# Filter by agent
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --agent claude
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --agent codex
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --agent gemini
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --agent opencode
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --agent hermes

# Search in prompts (AND logic, case-insensitive)
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --search "metal shader"

# Filter by project name or path
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --project radar

# Combine filters
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --agent claude --project aino --search "auth"

# JSON output (for parsing)
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --json --limit 10

# Resume a Claude Code session
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --resume <session-id>

# Control result count
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --limit 50

TUI: `claude-history`

Located at ~/.local/bin/claude-history. Rust-based fuzzy search TUI for Claude Code sessions only.

# Interactive fuzzy search across all Claude sessions
claude-history

# Scoped to current project
claude-history --local

# View a specific session file
claude-history /path/to/session.jsonl

# Resume selected session
claude-history --resume

# Fork from a past session
claude-history --fork-session

GUI: Claude Code History Viewer (CCHV)

Desktop app at /Applications/Claude Code History Viewer.app. Supports 7 agents (Claude, Codex, Gemini, Cursor, Cline, Aider, OpenCode) with analytics, cost tracking, and full-text search.

open "/Applications/Claude Code History Viewer.app"

Data Sources

Agent	Location	Format
Claude Code	`~/.claude/projects/<encoded>/*.jsonl`	JSONL with `type`, `message`, `cwd`, `sessionId`, `timestamp`
Codex CLI	`~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl`	JSONL with `session_meta` (payload.id, payload.cwd) and `response_item` entries
Gemini CLI	`~/.gemini/tmp//chats/session-.json`	JSON with `sessionId`, `startTime`, `messages[]` array
opencode	`~/.local/share/opencode/opencode.db`	SQLite tables: `session`, `message`, `part`, `project`
Hermes Agent	`~/.hermes/state.db`	SQLite tables: `sessions`, `messages`

Project mapping for Gemini: ~/.gemini/projects.json maps absolute paths to project names.

Workflow

Finding a past conversation

1. Run agent-sessions with appropriate filters to find the session 2. Note the session ID from the output 3. For Claude sessions: use claude --resume <id> to continue, or claude-history to browse 4. For viewing any agent's full conversation: open CCHV

Answering "what did I work on?"

# Yesterday's activity across all agents
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --limit 50 | head -20

# Specific project
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --project bloom-metal

# Specific agent
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --agent codex --limit 20

Resuming a session

# Find the session
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --search "shader bug" --agent claude --json

# Resume it (Claude only)
python3 /Users/vladmdgolam/Play/radar/tools/agent-sessions --resume <session-id>
# This execs into: claude --resume <session-id>

JSON Output Schema

When using --json, each session object has:

{
  "agent": "claude|codex|gemini|opencode|hermes",
  "session_id": "uuid",
  "prompt": "first user message (truncated to 120 chars)",
  "timestamp": "ISO 8601",
  "project_path": "/absolute/path/to/project",
  "project_name": "project-dir-name",
  "session_file": "/path/to/session/file"
}