A specialized utility to enumerate, filter, and inspect local Codex AI agent sessions and their associated metadata.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install codex-session-history
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install codex-session-history using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Codex Session History?
Codex Session History is a robust technical utility designed to provide deep visibility into your local AI development history. By interfacing directly with session indices and local storage paths, it allows developers to map specific AI interactions to their respective IDs, project titles, and workspace directories. This tool is essential for developers using Openclaw Skills who need to maintain an organized audit trail of their AI-assisted coding workflows.
The skill prioritizes data integrity by using the session files themselves as the source of truth, ensuring that even if the primary index is incomplete, your session data remains accessible. It handles complex time-zone conversions automatically, presenting UTC timestamps in your local time for intuitive filtering and review.
Codex Session History Use Cases
- Retrieving a specific session ID for a project worked on earlier in the week.
- Auditing AI interactions across multiple workspaces or Git repositories.
- Filtering session history by specific local time windows to track productivity.
- Identifying which project or directory a specific archived session originated from.
- Exporting session metadata to JSON for custom data analysis or reporting.
How Codex Session History Works
- The skill scans the local filesystem, specifically targeting
~/.codex/session_index.jsonland the sessions directories. - It extracts canonical session IDs and workspace anchors (CWD) directly from the session payloads.
- The tool attempts to resolve the project name by identifying the Git root of the workspace; otherwise, it defaults to the directory name.
- Metadata is enriched by merging information from the session index for thread naming and update timestamps.
- All timestamps are converted from UTC to the user's local time.
- The resulting dataset is filtered based on user-provided arguments (date, project, or status) and rendered in a clean table or JSON format.
Codex Session History Setup
Ensure you have Python 3 installed on your macOS or Linux system. To use this within your environment, execute the bundled script:
# List the most recent sessions to verify installation
python3 scripts/list_codex_sessions.py
Codex Session History Data Schema & Taxonomy
The skill organizes session data into a structured format. When using the --details flag, the following schema is populated:
| Field | Description |
|---|---|
id |
The canonical UUID for the Codex session. |
project |
The resolved Git project name or folder name. |
cwd |
The absolute path to the workspace directory. |
started_at |
Local timestamp of session initiation. |
source |
Indicates if the session is active or archived. |
title |
The thread name or a summary of the first user message. |
session_file |
The physical path to the session JSON file on disk. |
Codex Session History Advanced Features
- Multi-source aggregation: Combine active and archived session histories into a single view using the
--source allflag. - Granular time filtering: Narrow down sessions using specific
--date,--from, and--toparameters. - JSON Output: Seamlessly integrate with other Openclaw Skills by outputting machine-readable data via the
--jsonflag. - Deep Inspection: Use the
--detailsmode to view the first user message and full project paths for every session.
SKILL.md
Loading
Related Openclaw Skills
BFunBot
BFunBot is a versatile AI agent skill for deploying tokens on BSC, managing creator fee earnings, and accessing a unified LLM gateway.
Taobao Draft Generator
A professional tool for generating compliant Taobao product drafts with automated material consistency checks and SEO title optimization.
Taxi Expense Reimbursment Automation
An automated workflow for processing taxi order screenshots into desensitized, reimbursement-ready Excel reports using OCR and smart filtering.
rstack
A comprehensive suite of tools designed to help resolved.sh operators build, audit, and monetize their presence on the agentic web.
Taobao Ad Advisor
An AI-driven ad campaign strategy generator providing full lifecycle operational guidance for Taobao and Tmall sellers.
TripClaw Sync
A specialized skill designed to bridge AI-generated road trip itineraries with the TripClaw application via secure API synchronization.
Featured*
