I built DevRecap: an open-source Codex Skill that reconstructs what you actually worked on

I recently developed DevRecap, an open-source Codex Skill designed to reconstruct a developer's actual work activities. Despite frequent use of coding agents, I often struggled to recall the bigger picture of what I had accomplished. While Git records code history well, developer work extends beyond that. DevRecap aims to capture the full story by utilizing various local sources, including Codex and Claude Code session histories, as well as read-only Git evidence.

This information is then transformed into structured activities and workstreams that can be utilized for creating daily standups, weekly reviews, sprint recaps, project handoffs, performance reviews, and reports summarizing what you did. The core principle behind DevRecap is that AI writes the narrative, while the system determines the facts.

AI takes the structured facts and converts them into readable prose, ensuring that the report does not overstate what actually occurred. DevRecap implements several conservative rules, such as not automatically classifying a file edit as a completed feature or an investigation as a shipped fix. Completion claims require supporting evidence, and DevRecap strives to correlate multiple signals, like session intent, passing tests, and Git commits, to provide a more confident report.

The pipeline for DevRecap involves gathering evidence from Codex, Claude, and Git sources, followed by the factual runner, which generates activities, evidence, and workstreams. The AI layer then crafts the report, which is subsequently validated by DevRecap itself. Privacy is a key focus, with DevRecap being explicit-invocation only, meaning it only runs when the user explicitly requests.

Local sources are authorized by the user before collection, and Git access is restricted to read-only. DevRecap is designed to enhance developers' productivity by providing an accurate and useful record of their work, without turning the tool into an employee monitoring software. To use DevRecap, install it from the OpenAI Plugins Directory or through the GitHub marketplace for development versions.

Once installed, simply invoke the Skill and ask for a report, such as "$devrecap Help me remember what I worked on this week." The resulting report is organized around meaningful work fronts, making it easier to understand and present the developer's work.