csctf Skill

Convert public AI chat share links into clean, portable Markdown and HTML files. Preserves code blocks with language detection, generates deterministic filenames, and optionally publishes to GitHub Pages.

Supported Providers

Provider	URL Pattern	Method
ChatGPT	chatgpt.com/share/*	Headless Chromium
Gemini	gemini.google.com/share/*	Headless Chromium
Grok	grok.com/share/*	Headless Chromium
Claude	claude.ai/share/*	Your Chrome (uses session cookies)

Basic Usage

# Convert any share link to Markdown + HTML
csctf https://chatgpt.com/share/69343092-91ac-800b-996c-7552461b9b70

# Gemini conversation
csctf https://gemini.google.com/share/66d944b0e6b9

# Grok conversation
csctf https://grok.com/share/bGVnYWN5_d5329c61-f497-40b7-9472-c555fa71af9c

# Claude conversation (requires Chrome login)
csctf https://claude.ai/share/549c846d-f6c8-411c-9039-a9a14db376cf

Output:

• <conversation_title>.md - Clean Markdown with preserved code fences
• <conversation_title>.html - Styled static HTML (no JavaScript)

Output Options

# Markdown only (skip HTML)
csctf <url> --md-only

# HTML only (skip Markdown)
csctf <url> --html-only

# Custom output path
csctf <url> --outfile ~/exports/my_chat.md

# Quiet mode (minimal logging)
csctf <url> --quiet

Timeout Control

# Default is 60 seconds
csctf <url> --timeout-ms 60000

# For slow/large conversations
csctf <url> --timeout-ms 90000

# Very long conversations
csctf <url> --timeout-ms 120000

GitHub Pages Publishing

Publish conversations to a GitHub Pages site with auto-generated index:

# Publish with defaults (creates my_shared_conversations repo)
csctf <url> --publish-to-gh-pages --yes

# Custom repo
csctf <url> --publish-to-gh-pages --gh-pages-repo myuser/my-chats --yes

# Custom branch and directory
csctf <url> --publish-to-gh-pages --gh-pages-branch main --gh-pages-dir exports --yes

# Remember settings for future runs
csctf <url> --publish-to-gh-pages --remember --yes

# Then just use --yes for subsequent runs
csctf <url> --yes

# Clear remembered settings
csctf --forget-gh-pages

# Dry run (build index without pushing)
csctf <url> --publish-to-gh-pages --dry-run

Requirements for publishing:

• GitHub CLI (gh) installed and authenticated
• Run gh auth status to verify

All Flags

Flag	Default	Description
--timeout-ms	60000	Navigation + selector timeout
--outfile	auto	Override output path
--no-html / --md-only	off	Skip HTML output
--html-only	off	Skip Markdown output
--quiet	off	Minimal logging
--check-updates	off	Check for new version
--version	—	Print version
--publish-to-gh-pages	off	Publish to GitHub Pages
--gh-pages-repo	auto	Target repo (owner/name)
--gh-pages-branch	gh-pages	Target branch
--gh-pages-dir	csctf	Subdirectory in repo
--remember	off	Save GH settings
--forget-gh-pages	off	Clear saved settings
--dry-run	off	Simulate publish
--yes	off	Skip confirmation prompt
--gh-install	off	Auto-install gh CLI

Output Format

Markdown Structure

# Conversation: <Title>

**Source:** https://chatgpt.com/share/...
**Retrieved:** 2026-01-04T15:30:00Z

## User

How do I sort an array in Python?

## Assistant

Here's how to sort an array in Python:

```python
# Sort in place
my_list.sort()

# Return new sorted list
sorted_list = sorted(my_list)

### HTML Features

- Standalone (no external dependencies)
- Zero JavaScript
- Inline CSS with light/dark mode support
- Syntax highlighting via highlight.js (inline)
- Table of contents
- Print-friendly styles
- Language badges on code blocks

## Filename Generation

Filenames are automatically generated from conversation titles:
- Lowercased
- Non-alphanumerics → `_`
- Trimmed, max 120 chars
- Collision handling: `_2`, `_3`, etc.

Examples:

"How to Build a REST API" → how_to_build_a_rest_api.md "Python Tips & Tricks!" → python_tips_tricks.md

## Clawdbot Workflows

### "Save this ChatGPT conversation"

User: Can you save this conversation? https://chatgpt.com/share/abc123...

Clawdbot: Uses csctf to download and convert csctf "https://chatgpt.com/share/abc123..." --outfile ~/Documents/chats/

### "Archive all my shared chats"

```bash
# Save multiple conversations
csctf https://chatgpt.com/share/abc... --outfile ~/archive/
csctf https://gemini.google.com/share/xyz... --outfile ~/archive/
csctf https://claude.ai/share/def... --outfile ~/archive/

"Publish to my blog"

csctf https://chatgpt.com/share/abc... \
  --publish-to-gh-pages \
  --gh-pages-repo myuser/ai-conversations \
  --yes

"Quick export for reference"

# Just get the markdown, skip HTML
csctf https://chatgpt.com/share/abc... --md-only --quiet

Performance Notes

• First run: Downloads Playwright Chromium (~200MB, cached)
• Subsequent runs: 5-15 seconds depending on conversation length
• Claude.ai: Uses your installed Chrome (bypasses Cloudflare)

Claude.ai Special Handling

Claude.ai uses Cloudflare protection. csctf handles this by:

1. Copying your Chrome session cookies to a temp profile
2. Launching Chrome with remote debugging
3. Extracting conversation via Chrome DevTools Protocol

Requirements:

• Chrome installed
• Logged into claude.ai in your regular Chrome session
• If Chrome is running, tool will offer to save tabs, restart, and restore

Troubleshooting

Issue	Solution
"No messages found"	Link may be private or expired; verify it opens in browser
Timeout errors	Use --timeout-ms 90000 for slow/large conversations
Claude.ai won't load	Ensure you're logged into claude.ai in Chrome
Cloudflare challenge	Complete challenge in Chrome window, press Enter
Publish auth fails	Run gh auth status to verify GitHub CLI login
Filename collisions	Normal - tool appends _2, _3, etc.

File Locations

• Config: ~/.config/csctf/config.json (GitHub Pages settings)
• Playwright cache: ~/.cache/ms-playwright/
• Output: Current directory (or --outfile path)

Requirements

• Bun 1.3+ or prebuilt binary
• macOS, Linux, or Windows
• Chrome (for Claude.ai shares only)
• GitHub CLI (gh) for publishing (optional)