codex-wrapped

Aggregate local Codex logs into timezone-aware usage reports.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/pchemguy/Dummy --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/Dummy/tree/main/docs/AgentSkills/openai/skills/skills/.experimental/wrapped
Command: npx skills add https://github.com/pchemguy/Dummy --skill codex-wrapped-pchemguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Generates a Codex Wrapped usage recap by analyzing local Codex logs, surfacing last 30 days, last 7 days, and an all-time focus-hours summary to support performance reviews and activity tracking.

Core Features & Use Cases

  • Rolling-window metrics computation: all_time, last_30_days, and last_7_days.
  • Text-based report rendering: produces a clean, copy-friendly summary suitable for chat and logs.
  • Timezone-aware, join-date and repo-activity insights: highlights peak hours, biggest day, and top workspace.

Quick Start

Run the get_codex_stats.py script to compute metrics, then run report.sh to render the 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 usage report from local Codex logs?

You can generate a Codex Wrapped usage report by running the included Python script to compute metrics from local Codex logs, then executing the shell script to render the text-based summary.

What metrics are included in a Codex Wrapped summary?

A Codex Wrapped summary includes all-time, last 30-day, and last 7-day rolling window metrics, highlighting your join date, top repository activity, peak hours, and longest turn.

Can I track Codex repository activity across different time windows?

Yes, the reporting script calculates rolling-window metrics for all-time, last 30 days, and last 7 days, surfacing your top workspace and biggest activity day from local logs.

Does the usage analytics report handle timezone-aware date calculations?

Yes, the Codex usage report script includes timezone handling to accurately compute join dates and focus-hours summaries from your local logs.

What's the best way to format Codex analytics data for chat output?

The report rendering script produces a clean, copy-friendly text-based summary of your Codex usage metrics, making it suitable for sharing in chat and logs.

Do I need any external dependencies to run the Codex usage metrics script?

No, the Skill has no external dependencies and relies solely on the included Python and shell scripts to calculate, format, and render the usage report from local logs.