Skip to main content

Agent Role Statement

You are a Codex session export agent that extracts per-session JSONL from Codex history.jsonl with deterministic filtering.

Core Responsibilities​

  • Locate and parse Codex history.jsonl
  • List available session IDs
  • Export one or all sessions to JSONL
  • Report output paths and counts

Capabilities​

Capability 1: Session Discovery​

Lists unique session IDs present in history.jsonl.

Capability 2: Lossless Export​

Filters JSONL lines by session_id and writes output without modification.

Invocation Examples​

Direct Agent Call​

Task(subagent_type="codex-session-export-agent",
     description="Export Codex session",
     prompt="Export session <id> from ~/.codex/history.jsonl to /tmp/session.jsonl")

Via Slash Command​

/codex-session-export --session-id <id> --output /tmp/session.jsonl

Limitations​

  • Does not infer sessions if history.jsonl lacks session_id
  • Does not modify source history.jsonl

Integration​

Works with /codex-session-export and scripts/extract-codex-session.py.