Skill

gh-session-inventory

Discover session files for a repo across Claude Code, Codex, and Cursor, and extract session metadata (timestamps, branch, cwd, size, platform). Invoked by session-research agents — not intended for direct user queries.

Install

npx claudepluginhub wangrenzhu-ola/galeharnesscodingcli --plugin galeharness-cli

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Agent-facing primitive. Discover session files and emit session metadata as JSONL across Claude Code, Codex, and Cursor.

Supporting Assets

scripts/discover-sessions.shscripts/extract-metadata.py

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

166.1k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

166.1k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

166.1k

Stats

Parent Repo Stars7

Parent Repo Forks3

Last CommitApr 21, 2026

Actions

View Source View Plugin View on GitHub View README

Session inventory

Agent-facing primitive. Discover session files and emit session metadata as JSONL across Claude Code, Codex, and Cursor.

This skill exists so that agents researching session history do not need to know the layout of session stores on disk or the JSONL shapes of each platform. The scripts under scripts/ own that knowledge.

Arguments

Space-separated positional args:

<repo> — repo folder name (e.g., my-project). Used for directory matching in Claude Code and Cursor, and as the CWD filter for Codex sessions.
<days> — scan window in days (e.g., 7). Session files older than this are skipped.
<platform> (optional) — one of claude, codex, cursor. Omit to search all three.

Execution

Run the discovery-plus-metadata pipeline from the skill's own scripts/ directory:

bash scripts/discover-sessions.sh <repo> <days> [--platform <platform>] \
  | tr '\n' '\0' \
  | xargs -0 python3 scripts/extract-metadata.py --cwd-filter <repo>

Return the raw stdout verbatim — one JSON object per session, then a final _meta line. Callers parse the JSONL directly, so do not paraphrase, reformat, or summarize.

If discovery finds no files, the pipeline still emits a clean _meta line (files_processed: 0). Return that as-is.

Output format

Each session line is a JSON object. Common fields across platforms:

platform — claude, codex, or cursor
file — absolute path to the session JSONL
size — file size in bytes
ts — session start timestamp (ISO 8601)
session — session identifier

Platform-specific fields:

Claude Code adds branch (git branch) and last_ts (last message timestamp).
Codex adds cwd (working directory), source, cli_version, model, last_ts.
Cursor has no in-file timestamps or metadata — ts is derived from file mtime and session from the containing directory name.

The final _meta line has files_processed, parse_errors, and optionally filtered_by_cwd (count of Codex sessions dropped by the CWD filter).

Error handling

If the discovery script errors (e.g., unreadable home directory, permission failure), let the error surface to the caller. Do not substitute git log, file listings, or other sources — this skill's contract is session metadata, nothing else.

If _meta reports parse_errors > 0, return the JSONL as-is. The caller decides how to handle partial data.