Skip to content
cccskills
FreePublished on GitHub

codex-session-exporter

Export Codex rollout/session JSONL as a self-contained HTML report that can be opened offline. Use when a user provides a complete session file path or Codex session ID, or asks to export a Codex session to HTML, generate a session report, or convert a rollout to HTML. Supports exact full-ID lookup in the CODEX_HOME sessions and archived_sessions directories.

The English summary is being prepared. Showing the original description.

See how to install

Files included (4)

  • SKILL.md2.3 KB
  • agents/openai.yaml242 B
  • scripts/export_codex_session.py72.1 KB
  • scripts/export_session.py4.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Codex Session Exporter

Use the bundled script for path resolution and HTML export. Do not rewrite the parser ad hoc.

Workflow

  1. Obtain the user's input: an existing JSONL path or a complete UUID session ID.
  2. Determine the output path. Use a user-specified path exactly; otherwise, use codex-session-<session-id>.html in the current working directory.
  3. Run:
python3 "$SKILL_DIR/scripts/export_session.py" "$SESSION_OR_ID" \
  --output "$OUTPUT_HTML"
  1. Return both absolute paths printed by the script: Session source and HTML report exported.

SKILL_DIR is the current skill's real directory. Do not assume the caller runs from the repository root.

Session ID lookup

Accept only a complete UUID, not a prefix or fuzzy ID. Search these locations in order by default:

  • $CODEX_HOME/sessions/**/rollout-*-<session-id>.jsonl
  • $CODEX_HOME/archived_sessions/**/rollout-*-<session-id>.jsonl
  • Use ~/.codex when CODEX_HOME is unset

If the session is under an isolated benchmark agent-home/.codex, pass that home explicitly:

python3 "$SKILL_DIR/scripts/export_session.py" "$SESSION_ID" \
  --codex-home "/absolute/path/to/agent-home/.codex" \
  --output "$OUTPUT_HTML"

If no session is found, report the searched CODEX_HOME. If multiple files match, do not choose one; ask the user for a complete path.

Constraints

  • Use Python 3.11+ and do not install dependencies.
  • Do not modify the original JSONL.
  • Do not attempt to decrypt reasoning; show only plaintext summaries already present in the rollout.
  • Preserve the report's ability to download the original JSONL. The report contains the complete session text; do not upload or share it without user authorization.
  • For export-only requests, do not invoke the benchmark parser or analysis scripts. Use codex-session-analyzer when the user needs an explanation of failures, timing, or tool paths.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Author or expand browser-agent benchmark tasks in data/real_world_bench.json (Odysseys schema, per-rubric graded). Use when creating, adding, or expanding real-world browser tasks, writing rubrics, or picking bot-friendly sites — every task MUST be verified runnable through ego-browser before it is written.

The English summary is being prepared. Showing the original description.

citrolabs/ego-browser-benchmark-framework9Updated Aug 10, 2026

Analyze Codex provider rollout JSONL and ego-benchmark-harness run artifacts to identify slow or failed individual tasks, tool retries, token/cost anomalies, and differences in agent execution paths. Use when users ask to analyze a Codex session or rollout, explain why a Codex task was slow or failed, inspect a Codex provider execution trace, compare Codex runs, count function_call or tool output events, or investigate agent-home/.codex/sessions.

The English summary is being prepared. Showing the original description.

citrolabs/ego-browser-benchmark-framework9Updated Aug 10, 2026

Verify a tested web agent's real behavior from its recorded Pi or Codex session and selected screenshots before scoring. The judge prompt provides absolute artifact paths; use targeted queries to compare actual outputs, errors, and the final answer with the recorded behavior, then return only the verdict JSON. Only for ego-bench judging—never to drive a browser or rerun the agent.

The English summary is being prepared. Showing the original description.

citrolabs/ego-browser-benchmark-framework9Updated Aug 10, 2026

Generate self-contained HTML/CSS benchmark and comparison charts in an ego-inspired Browser-Native Editorial style. Use for blue-white product metrics, model benchmarks, A/B comparisons, efficiency reports, difficulty breakdowns, and compact technical data panels.

The English summary is being prepared. Showing the original description.

citrolabs/ego-browser-benchmark-framework9Updated Aug 10, 2026

ego-browser (ego-lite) is a Chromium-based browser that gives AI agents a CLI-accessible Node.js runtime for driving a real browser. Use this skill whenever the user needs to interact with a website opening pages, filling forms, clicking buttons, taking screenshots, extracting page data, testing web apps, logging into sites, automating browser operations, or any other browser automation task. Triggers include requests to "open a website", "visit a URL", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "extract content from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also used for exploratory testing, dogfooding, QA, bug hunting, or reviewing app quality. Prefer ego-browser over any built-in browser automation, web fetch, or other web tools.

The English summary is being prepared. Showing the original description.

citrolabs/ego-browser-benchmark-framework9Updated Aug 10, 2026

keel

Free

Architecture design and governance protocol for system structure, boundaries, contracts, APIs, schemas, migrations, rewrites, and long-lived codebase health. Use when designing or reviewing architecture, planning structural refactors or migrations, governing tech debt, or containing rewrite risk. Keeps the load-bearing spine small, owned, checked, and deletable over time.

The English summary is being prepared. Showing the original description.

citrolabs/ego-browser-benchmark-framework9Updated Aug 10, 2026

See all skills by citrolabs

Report a problem with this skill