← Back to Skills Marketplace
240
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install codex-export
Description
Export a Codex CLI or Codex Desktop (App) session to a Markdown transcript. Use when the user asks to export, save, share, or review a past chat, session, or...
README (SKILL.md)
codex-export
Export any Codex session (~/.codex/sessions/**/*.jsonl) to a clean Markdown file.
Usage
# List recent sessions (pick by number or copy the ID)
python3 scripts/export.py --list
# Export by session ID
python3 scripts/export.py \x3Csession-id> output.md
# Brief mode: user + assistant only, no tool calls
python3 scripts/export.py \x3Csession-id> output.md --brief
Notes
- Works with Codex Desktop (
source=vscode) and Codex CLI (source=cli/exec) - Session IDs come from
~/.codex/state_5.sqliteor the rollout filename - System/developer messages and
\x3Cenvironment_context>blocks are filtered automatically - Tool call outputs are included by default; use
--briefto strip them
Usage Guidance
This script reads files in ~/.codex (sessions and the state_5.sqlite index) and writes a Markdown file you specify. Before installing or running it: (1) review the small Python file (it’s included) to confirm it only reads local session files and the sqlite DB; (2) be aware exported transcripts may contain sensitive data (API keys, paths, tool outputs) — use --brief to omit tool calls and inspect the output before sharing; (3) run it locally (not as a privileged user) and control the output file location and permissions. The skill’s source is unknown, but the code is short and consistent with its stated purpose.
Capability Analysis
Type: OpenClaw Skill
Name: codex-export
Version: 0.1.0
The codex-export skill is a utility designed to export local Codex session histories from ~/.codex/ to Markdown format. The script (scripts/export.py) reads session logs and a local SQLite database (~/.codex/state_5.sqlite) to list and format chat transcripts as requested by the user. The code is straightforward, lacks network connectivity, and contains no evidence of malicious intent, data exfiltration, or obfuscation.
Capability Assessment
Purpose & Capability
Name/description match required behavior: the code and instructions only access Codex session JSONL files and the local state_5.sqlite index to list and export sessions, which is exactly what an export tool needs.
Instruction Scope
SKILL.md directs the agent/user to run the included Python script to list or export sessions. The runtime instructions and script operate on local paths (~/.codex/sessions, ~/.codex/archived_sessions, ~/.codex/state_5.sqlite) and do not attempt to read other system-wide configs or send data externally.
Install Mechanism
No install spec or remote downloads; this is an instruction-only skill with a small local Python script — minimal install risk.
Credentials
The skill requires no environment variables, credentials, or network access. It only reads local Codex session files and the local sqlite index, which is proportionate to its stated purpose.
Persistence & Privilege
Skill is user-invocable and not always-enabled; it does not modify other skills or system settings and does not request permanent privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install codex-export - After installation, invoke the skill by name or use
/codex-export - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of codex-export.
- Export Codex CLI or Codex Desktop sessions to Markdown transcripts.
- Supports listing recent sessions, brief mode (user + assistant only), and exporting by session ID.
- Automatically filters system messages and environment context blocks.
- Handles both Codex CLI and Desktop app sessions.
- Includes or omits tool call outputs based on `--brief` flag.
Metadata
Frequently Asked Questions
What is codex-export?
Export a Codex CLI or Codex Desktop (App) session to a Markdown transcript. Use when the user asks to export, save, share, or review a past chat, session, or... It is an AI Agent Skill for Claude Code / OpenClaw, with 240 downloads so far.
How do I install codex-export?
Run "/install codex-export" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is codex-export free?
Yes, codex-export is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does codex-export support?
codex-export is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created codex-export?
It is built and maintained by jinghan23 (@jinghan23); the current version is v0.1.0.
More Skills