chatgpt-share-dump

npx github:tombelieber/chatgpt-share-dump --url "https://chatgpt.com/share/..." --out ./chatgpt-archive --zip

ChatGPT share pages are built for humans to read in a browser. Agents need something else: a complete, replayable archive with structured turns, current-state handoff context, and explicit media validation.

chatgpt-share-dump parses the ChatGPT share payload directly. It does not scroll the browser UI, so it avoids missing long conversations that are virtualized on screen.

Distribution is GitHub-first. The tracked installer is the primary install path; GitHub/npx commands are the fallback for environments that prefer npm tooling without requiring an npm registry package.

Output

Each dump writes:

• visible-turns.json - canonical structured visible turns
• full-transcript.md - readable Markdown transcript
• CURRENT_SNAPSHOT.md - latest-turn state and coverage
• CHAT_CONTEXT_FOR_CODEX_FULL.md - agent-ready context file
• assets_manifest.json / assets_manifest.csv - media rows and validation state
• MEDIA_STATUS.md - media coverage summary
• MISSING_MEDIA.md - written when strict media validation fails
• raw-share.html - raw share page payload for parser repair/debugging

Usage

No-install run

npx github:tombelieber/chatgpt-share-dump \
  --url "https://chatgpt.com/share/..." \
  --out "/absolute/output/dir" \
  --zip

Global install

curl -fsSL https://chatgpt-share-dump.tomtang3.ai/install.sh | sh

This installs the CLI from github:tombelieber/chatgpt-share-dump, installs the bundled agent skill to both user skill homes, and marks the source as install_sh for install-source tracking.

Default skill destinations:

• Codex: ~/.codex/skills/chatgpt-share-dump
• Claude: ~/.claude/skills/chatgpt-share-dump

To install only one side:

CHATGPT_SHARE_DUMP_TARGET=codex curl -fsSL https://chatgpt-share-dump.tomtang3.ai/install.sh | sh
CHATGPT_SHARE_DUMP_TARGET=claude curl -fsSL https://chatgpt-share-dump.tomtang3.ai/install.sh | sh

GitHub install

npm install -g github:tombelieber/chatgpt-share-dump
chatgpt-share-dump install

chatgpt-share-dump install defaults to --target both. Use --target codex or --target claude when you only want one user skill folder updated. This uses npm tooling to install from GitHub; it does not require an npm registry publish.

Source tracking

Like claude-view, this project tracks install/source channels without collecting user content:

The beacon sends only source and package version to https://chatgpt-share-dump.tomtang3.ai/ping. It does not send ChatGPT share URLs, transcript text, raw HTML, output paths, asset filenames, local usernames, or credentials. Set CHATGPT_SHARE_DUMP_DISABLE_INSTALL_PING=1 or DO_NOT_TRACK=1 to disable the beacon.

If the shared conversation includes uploaded or generated media, provide the complete local assets folder:

npx github:tombelieber/chatgpt-share-dump \
  --url "https://chatgpt.com/share/..." \
  --out "/absolute/output/dir" \
  --assets-dir "/absolute/assets/folder" \
  --zip

Media validation is strict. If the share contains media and the local assets folder is missing, incomplete, or has files whose byte size does not match the share payload, the command exits non-zero and does not create a success zip.

Agent Skill

This package includes a reusable Codex/Claude-style skill for agents.

Codex setup:

curl -fsSL https://chatgpt-share-dump.tomtang3.ai/install.sh | sh
# or, after npm/GitHub install:
chatgpt-share-dump install --target codex

Claude setup:

claude plugin marketplace add tombelieber/tomstack
claude plugin install chatgpt-share-dump@tomstack

The CLI installer also supports direct Claude user-skill install:

chatgpt-share-dump install --target claude

Use it when a user gives an agent a ChatGPT share link and asks the agent to continue, analyze, test, migrate, summarize, implement from, or preserve that conversation.

Debug Inputs

Use --raw /absolute/raw-share.html to parse an already-fetched share page.