Export Session

This bundle contains the export-session/ Codex skill plus this README.

What It Does

export-session exports the active Codex CLI session to a file in a TUI-style transcript format.

The exported transcript includes:

• user prompts
• assistant commentary and final responses
• tool activity such as Explored, Ran, and Edited blocks

Portability

The skill does not hardcode a specific user or host path.

For session discovery it uses:

• $CODEX_HOME/sessions when CODEX_HOME is set
• ~/.codex/sessions when CODEX_HOME is unset

For output files it resolves relative paths from the caller's current working directory.

Install

Copy the export-session/ directory into:

${CODEX_HOME:-$HOME/.codex}/skills/

Example:

cp -R export-session "${CODEX_HOME:-$HOME/.codex}/skills/"

After installation, Codex can discover the skill as $export-session.

Usage

From a Codex session:

$export-session session.txt

From the shell:

python3 "${CODEX_HOME:-$HOME/.codex}/skills/export-session/scripts/export_session.py" session.txt

Overwrite Safety

If the destination file already exists:

• interactive runs prompt before overwrite
• non-interactive runs refuse to overwrite unless --force is passed

Example:

python3 "${CODEX_HOME:-$HOME/.codex}/skills/export-session/scripts/export_session.py" session.txt --force

Packaging

The shareable unit is the export-session/ directory. Keep that directory intact.

This README is intentionally outside the skill directory so the skill folder itself remains minimal and portable.