mcpbeat

Share Session

posthog/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.

342 tokens
context cost
the whole folder, loaded on every use
2
files
instructions only
0
copies elsewhere
how many repositories repackaged it
0
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/PostHog/codex-share-plugin --skill share-session

What comes with it

179 bytes besides the instruction
agents/openai.yaml

The instruction itself

1 sections, as written by the author

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.

How to use it

Copy the folder

Take posthog/share-session from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.