← Back to Skills Marketplace
bestisblessed

Export

by bestisblessed · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
63
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install export
Description
Export a Codex session JSONL from ~/.codex/sessions into a clean Markdown transcript in ~/Documents/Exports. Use when the user wants to export, save, or conv...
README (SKILL.md)

Export Conversation

Run scripts/export_conversation.py.

This exports the current chat by default using the Codex thread id from the environment.

To export a different conversation, pass a raw session id, for example:

scripts/export_conversation.py 019dc927-dac9-7f23-b313-917d776d189e

The script reads from ~/.codex/sessions and writes:

~/Documents/Exports/\x3Csession-id>.md

Print the saved path after running it.

Make sure ~/Documents/Exports already exists before running the script.

Usage Guidance
This script appears to do exactly what it claims: convert local Codex session JSONL to Markdown. Before running it: (1) ensure ~/Documents/Exports exists (the script will not create it); (2) prefer invoking the script with an explicit session id (scripts/export_conversation.py <session-id>) because if you rely on the default behavior the script expects CODEX_THREAD_ID to be set in the environment — that env var is referenced by the code but not declared in the skill metadata; (3) review the contents of ~/.codex/sessions for any sensitive information before exporting or moving files; (4) note the filename construction uses match.stem[28:], which may produce unexpected or truncated filenames — verify outputs after a test run. No network calls or external installs are present, so the skill operates locally. If you want higher assurance, run the script manually on a non-sensitive session first or inspect it in a sandbox.
Capability Analysis
Type: OpenClaw Skill Name: export Version: 1.0.1 The skill bundle is a utility designed to export local Codex session logs from JSONL format to Markdown. The Python script (scripts/export_conversation.py) reads session data from ~/.codex/sessions and writes the formatted output to ~/Documents/Exports. There is no evidence of data exfiltration, network activity, or malicious execution; the script's behavior is transparent and strictly aligned with the functionality described in SKILL.md.
Capability Assessment
Purpose & Capability
The included script reads files from ~/.codex/sessions and writes Markdown files to ~/Documents/Exports, matching the skill name and description.
Instruction Scope
SKILL.md instructs running scripts/export_conversation.py and describes expected I/O. The runtime instructions and script remain within the stated purpose (reading local session files and producing Markdown). The SKILL.md explicitly requires the ~/Documents/Exports directory to exist before running.
Install Mechanism
No install spec — instruction-only skill with an included script; nothing is downloaded or installed. This is low-risk from an install perspective.
Credentials
The registry metadata lists no required environment variables, but the script will read os.environ['CODEX_THREAD_ID'] when no session-id argument is passed. SKILL.md mentions using the Codex thread id from the environment, but the skill metadata did not declare this env var. This mismatch can cause runtime failures and is an undeclared dependency on a potentially sensitive env var.
Persistence & Privilege
The skill is not always-enabled and does not attempt to modify other skills or system-wide settings. It only reads and writes files under the user's home directories.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install export
  3. After installation, invoke the skill by name or use /export
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- No user-facing changes in this version. - Internal changes: updated scripts/export_conversation.py (details not provided).
v1.0.0
- Initial release of the export skill. - Allows exporting Codex session JSONL files into clean Markdown transcripts. - Default export uses the current chat's thread id; alternatively, specify a different session id. - Exported Markdown files are saved to ~/Documents/Exports. - Reminder: Ensure ~/Documents/Exports exists before running the script.
Metadata
Slug export
Version 1.0.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is Export?

Export a Codex session JSONL from ~/.codex/sessions into a clean Markdown transcript in ~/Documents/Exports. Use when the user wants to export, save, or conv... It is an AI Agent Skill for Claude Code / OpenClaw, with 63 downloads so far.

How do I install Export?

Run "/install export" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Export free?

Yes, Export is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Export support?

Export is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Export?

It is built and maintained by bestisblessed (@bestisblessed); the current version is v1.0.1.

💬 Comments