ce-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.
Best for Session research agentsWorks with GitHubLow risk
⌘source
- author
@EveryInc- language
- TypeScript
★15kstars
1.2kforks
Apr 21, 2026
✦overview.md
Key Features
- ·Discovers session files across Claude Code, Codex, and Cursor
- ·Extracts session metadata (timestamps, branch, cwd, size, platform)
- ·Outputs JSONL format for easy parsing
- ·Filters by repo and time window
- ·Agent-facing primitive with clear execution command
Use Cases
- →Researching session history across multiple AI coding platforms
- →Analyzing developer workflow patterns from session metadata
- →Auditing session activity for a specific repository
- →Building tools that process session data from Claude Code, Codex, and Cursor
Best for
- ✓Session research agents
- ✓Developer analytics tools
- ✓Workflow analysis systems
Not ideal for
- !Direct user queries
- !Real-time session monitoring
- !One-off manual analysis
FAQs
name
ce-session-inventory
description
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.
user-invocable:false
context:fork
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 ofclaude,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.
$install
1-click copynpx skills add EveryInc/compound-engineering-plugin --skill ce-session-inventorySafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.