wimi321/codex-chat-export

Latest recorded source activity: March 26, 2026 at 16:53

SkillsMP catalog refreshed: November 9, 2026 at 14:22

skills collected: 1

GitHub stars: 1
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/wimi321/codex-chat-export.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# codex-chat-export [![CI](https://github.com/wimi321/codex-chat-export/actions/workflows/ci.yml/badge.svg)](https://github.com/wimi321/codex-chat-export/actions/workflows/ci.yml) [![Release](https://img.shields.io/github/v/release/wimi321/codex-chat-export)](https://github.com/wimi321/codex-chat-export/releases) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE) A GitHub-ready Codex Skill for exporting local Codex Desktop conversations into clean Markdown or JSON. ## What it does - Lists local Codex conversations from `~/.codex/state_5.sqlite` - Exports transcript content from `~/.codex/sessions/**/rollout-*.jsonl` - Supports Markdown and JSON output - Optionally includes tool calls and tool outputs - Filters noisy internal records by default - Creates a `manifest.json` during batch export - Ships both as a Codex Skill and an installable Python CLI - Works well for backups, audits, publishing, or migrating useful threads ## Install ### As a Codex Skill Clone or copy this folder into your Codex skills directory: ```bash ./scripts/install_skill.sh ``` Then invoke it in Codex with `$codex-chat-export`. ### As a Python CLI ```bash . .venv/bin/activate 2>/dev/null || true python3 -m venv .venv . .venv/bin/activate python3 -m pip install . codex-chat-export list ``` Or with `pipx`: ```bash pipx install . ``` ## CLI usage ```bash codex-chat-export list codex-chat-export list --contains 导出 --limit 10 codex-chat-export export --latest --format markdown codex-chat-export export --contains 复盘 --format json --output exports/ codex-chat-export export --updated-after 2026-03-01T00:00:00+00:00 --output exports/ codex-chat-export export --id <thread-id> --include-tools --output thread.md ``` ## Output - Single export writes one `.md` or `.json` file - Batch export writes one file per thread plus `manifest.json` - Default export strips leading `<environment_context>` blocks from user messages See [examples/sample-thread.md](./examples/sample-thread.md) for the Markdown shape. ## Development ```bash python3 -m unittest discover -s tests -v ``` ## Release Push a tag like `v0.1.0` and GitHub Actions will attach `codex-chat-export-skill.zip` to the release.

Loading the repository README…

Skills in this repository

Software Developers

1 occupation category · 100% classified

skill

occupation

description

updated

codex-chat-export

Software Developers

Export local Codex Desktop conversations from ~/.codex into Markdown or JSON. Use this skill when the user wants to back up chat history, extract a thread by id or title, batch-export multiple conversations, or turn rollout JSONL sessions into readable…

2026-03-26

Showing 1 of 1 collected skill.