Skip to content

README.md

Latest commit

 

History

History
73 lines (44 loc) · 1.59 KB

README.md

File metadata and controls

73 lines (44 loc) · 1.59 KB

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.