share-session

Preview or publish the current Codex coding session as readable Markdown in a configured GitHub repository. Use when the user asks to share, export, publish, or save a Codex session or transcript.

Jump to install

Repository: PostHog/codex-share-plugin
Last source activity: July 21, 2026 at 20:44
Detected SKILL.md language: English
Stars: 0
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/PostHog/codex-share-plugin --skill share-session

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

name	share-session
description	Preview or publish the current Codex coding session as readable Markdown in a configured GitHub repository. Use when the user asks to share, export, publish, or save a Codex session or transcript.

Share a Codex session

Use the bundled script at ../../scripts/share_session.py.

Verify gh auth status succeeds.
Run the script without --push, passing the user's description after --description. This creates a local Markdown preview and prints its path.
Tell the user that transcripts can contain source code, prompts, tool inputs, local paths, or secrets. Ask them to approve publishing after they review the preview.
Only after explicit approval, rerun with the same description and --push.
Return the GitHub URL printed by the script.

If no repository is configured, ask for owner/repo, then run:

python3 ../../scripts/share_session.py --configure-repo owner/repo

Configuration is stored in ${CODEX_HOME:-~/.codex}/share-plugin-config.json. CODEX_SHARE_REPO overrides the file.

Never publish without the preview and explicit approval. Do not expose transcript contents in chat unless the user asks.

share-session

Source facts

Install options

Review the source files

Share a Codex session

Share a Codex session