skills.rest
syl2042
syl2042COMMUNITY
Explore all skills by this author →
GitHub

codex-wrapped

Aggregate local Codex logs into rolling usage metrics and reports.

Updated Feb 5, 2026
Search Tags:#logs#codex#metrics#usage#report#timezones#wrapped
One-click install
npx skills add https://github.com/syl2042/codex_skills --skill codex-wrapped
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-wrapped
Source: https://github.com/syl2042/codex_skills/tree/main/wrapped
Command: npx skills add https://github.com/syl2042/codex_skills --skill codex-wrapped

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates Codex usage analytics by deriving rolling metrics from local logs to deliver clear, actionable reports.

Core Features & Use Cases

  • Generate a Codex Wrapped usage report from your local Codex activity logs, including last 30 days, last 7 days, and all-time focus-hours.
  • Support for both time-window summaries and top-repo insights to inform product and engineering discussions.
  • Use in status updates, weekly summaries, or onboarding demos to illustrate activity patterns and focus intensity.

Quick Start

Run the stats script to generate the wrapped_stats.json and render the text report to stdout.

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?▼

Codex usage analysis aggregates local Codex logs into rolling performance metrics for time-bounded windows. It processes your activity data to produce concise usage recaps, including peak activity times and top repositories, for downstream reporting.

How do I automate Codex usage metrics for the last 30 days?▼

Automate weekly Codex activity summaries by running the stats script to process local logs into 7-day rolling metrics. The script calculates focus-hours and top-repo insights, rendering a structured usage recap suitable for status updates.

Can I use local Codex logs to track focus-hours across different time zones?▼

Yes, the Codex usage analysis script respects time zones when processing local logs. It accurately aggregates activity data into rolling performance metrics regardless of your local time zone settings.

What is the best way to summarize all-time Codex activity and top repositories?▼

The best way to summarize all-time Codex activity is to parse local logs with an automated Python script. It calculates all-time totals, peak activity, and top repositories, outputting a structured metrics object for downstream rendering.

Does the Codex Wrapped report require external dependencies to process local logs?▼

No, generating Codex usage reports from local logs requires no external dependencies. The Skill uses standalone Python scripts to process local log files and output structured metrics objects directly.

Why are my Codex usage metrics not working when parsing local log files?▼

Codex usage metrics may fail if local logs lack required activity timestamps or repository data. The Python script depends on properly formatted local logs to calculate accurate time-bounded metrics and peak activity insights.

Related Skills

Explore More Data & Analytics Skills→
wangqianCAIwangqianCAI

model-usage

Summarize CodexBar JSONL cost logs for Codex and Claude providers.

Community
Intermediate
arielZusmanarielZusman

session-management

Monitor session health and rotate Claude Code sessions to prevent context rot.

Community
Basic
Proxy2021Proxy2021
5

error_monitor

Aggregate Enso error and action logs into a real-time monitoring dashboard.

Community
Advanced
chiptoe-svgchiptoe-svg

add-dashboard

Add a local monitoring dashboard for NanoClaw deployments.

Community
Intermediate