baoyu-danger-x-to-markdown Checked

| Result | Action |

|--------|--------|

| Found | Read, parse, apply settings |

| Not found | **MUST** run first-time setup (see below) — do NOT silently create defaults |

**EXTEND.md supports**: Download media by default, default output directory.

### First-Time Setup (BLOCKING)

**CRITICAL**: When EXTEND.md is not found, you **MUST use AskUserQuestion** to ask the user for their preferences before creating EXTEND.md. **NEVER** create EXTEND.md with defaults without asking. This is a **BLOCKING** operation — do NOT proceed with any conversion until setup is complete.

Use AskUserQuestion with ALL questions in ONE call:

**Question 1** — header: "Media", question: "How to handle images and videos in tweets?"

• "Ask each time (Recommended)" — After saving markdown, ask whether to download media
• "Always download" — Always download media to local imgs/ and videos/ directories
• "Never download" — Keep original remote URLs in markdown

**Question 2** — header: "Output", question: "Default output directory?"

• "x-to-markdown (Recommended)" — Save to ./x-to-markdown/{username}/{tweet-id}.md
• (User may choose "Other" to type a custom path)

**Question 3** — header: "Save", question: "Where to save preferences?"

• "User (Recommended)" — ~/.baoyu-skills/ (all projects)
• "Project" — .baoyu-skills/ (this project only)

After user answers, create EXTEND.md at the chosen location, confirm "Preferences saved to [path]", then continue.

Full reference: references/config/first-time-setup.md (references/config/first-time-setup.md)

### Supported Keys

| Key | Default | Values | Description |

|-----|---------|--------|-------------|

| download_media | ask | ask / 1 / 0 | ask = prompt each time, 1 = always download, 0 = never |

| default_output_dir | empty | path or empty | Default output directory (empty = ./x-to-markdown/) |

**Value priority**:

1. CLI arguments (--download-media, -o)

2. EXTEND.md

3. Skill defaults

Usage

${BUN_X} {baseDir}/scripts/main.ts <url>
${BUN_X} {baseDir}/scripts/main.ts <url> -o output.md
${BUN_X} {baseDir}/scripts/main.ts <url> --download-media
${BUN_X} {baseDir}/scripts/main.ts <url> --json

Options

| Option | Description |

|--------|-------------|

| <url> | Tweet or article URL |

| -o <path> | Output path |

| --json | JSON output |

| --download-media | Download image/video assets to local imgs/ and videos/, and rewrite markdown links to local relative paths |

| --login | Refresh cookies only |

Supported URLs

• https://x.com/<user>/status/<id>
• https://twitter.com/<user>/status/<id>
• https://x.com/i/article/<id>

Output

---
url: "https://x.com/user/status/123"
author: "Name (@user)"
tweetCount: 3
coverImage: "https://pbs.twimg.com/media/example.jpg"
---

Content...

**File structure**: x-to-markdown/{username}/{tweet-id}/{content-slug}.md

When --download-media is enabled:

• Images are saved to imgs/ next to the markdown file
• Videos are saved to videos/ next to the markdown file
• Markdown media links are rewritten to local relative paths

Media Download Workflow

Based on download_media setting in EXTEND.md:

| Setting | Behavior |

|---------|----------|

| 1 (always) | Run script with --download-media flag |

| 0 (never) | Run script without --download-media flag |

| ask (default) | Follow the ask-each-time flow below |

### Ask-Each-Time Flow

1. Run script **without** --download-media → markdown saved

2. Check saved markdown for remote media URLs (https:// in image/video links)

3. **If no remote media found** → done, no prompt needed

4. **If remote media found** → use AskUserQuestion:

• header: "Media", question: "Download N images/videos to local files?"
• "Yes" — Download to local directories
• "No" — Keep remote URLs

5. If user confirms → run script **again** with --download-media (overwrites markdown with localized links)

Authentication

1. **Environment variables** (preferred): X_AUTH_TOKEN, X_CT0

2. **Chrome login** (fallback): Auto-opens Chrome, caches cookies locally

Extension Support

Custom configurations via EXTEND.md. See **Preferences** section for paths and supported options.