skills.rest
pchemguy
pchemguyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

codex-wrapped

Generate a Codex usage recap report from local session logs.

Updated Feb 4, 2026
Search Tags:#analytics#codex#developer productivity#session logs#usage report#terminal report
One-click install
npx skills add https://github.com/pchemguy/AISandbox --skill codex-wrapped-pchemguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-wrapped
Source: https://github.com/pchemguy/AISandbox/tree/main/docs/AgentSkills/openai/skills/skills/.experimental/wrapped
Command: npx skills add https://github.com/pchemguy/AISandbox --skill codex-wrapped-pchemguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Developers using Codex lack visibility into their own usage patterns, such as how many sessions they run, when they are most active, and how much focus time they accumulate. This Skill aggregates local Codex session logs into a formatted Wrapped-style recap report. ## Core Features & Use Cases - Rolling-window statistics: Computes metrics for all time, the last 30 days, and the last 7 days, including sessions, prompts, tokens, active days, streaks, and peak hours. - Text report rendering: Prints a box-drawn terminal report with highlights, activity bars, and a two-column or table layout that adapts to terminal width. - Use Case: At the end of the month, ask for a Codex Wrapped report to see your prompt count, top repository, longest turn, and all-time focus hours rendered as a shareable text panel. ## Quick Start Ask the assistant to generate a Codex Wrapped usage report from your local Codex logs.

Frequently Asked Questions about codex-wrapped

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Codex Wrapped usage report?▼

Run get_codex_stats.py to compute metrics into a JSON file, then run report.sh with --stats-file pointing at that JSON. The report prints directly to stdout as a formatted text panel.

What metrics does the Codex usage report include?▼

The report covers sessions, assistant and user messages, tokens, active days, usage streaks, peak hour, biggest day, top repository, longest turn, and all-time focus hours. Metrics are broken down for all time, last 30 days, and last 7 days.

Where does the skill read Codex session data from?▼

It scans the sessions and archived_sessions directories under the ~/.codex folder, parsing every .jsonl session file. No network access or external service is required.

Can I change the report layout or width?▼

Yes. Pass --layout table to report.sh for a compact grid instead of the default two-column layout, or set WRAPPED_LAYOUT=table. Set WRAPPED_WIDTH to force a specific panel width instead of auto-detecting the terminal size.

Does the report support different timezones?▼

The stats script defaults to the system timezone for local-time calculations. You can override it with the --timezone flag using an IANA timezone name, falling back to UTC if the zone is unavailable.

Related Skills

Explore More Software Engineering Skills→
kevinslinkevinslin
21

dev.llm-session

Parse Codex session metadata from history JSONL and resume the matching session.

Community
Intermediate
geoffreywoogeoffreywoo

retro

Generates weekly engineering retrospective reports from Git commit history and per-author statistics.

Community
Advanced
tygwantygwan
1

analytics

Aggregate and visualize CLI tool usage statistics from telemetry metrics.

Community
Intermediate
harnessprotocolharnessprotocol
9

stats

Generate an interactive HTML dashboard from local Claude Code session data.

Official
Intermediate