\n \n ![\"Composio](\"assets/media/awesome-agent-skills.png\")
\n \n
\n \n \n \n
| 🤖 AI 模型与平台 | ||||
|---|---|---|---|---|
| anthropics | \nopenai | \ngemini | \nhuggingface | \nreplicate | \n
| elevenlabs | \nblack-forest-labs | \n\n | \n | \n |
| ☁️ 云服务与基础设施 | ||||
| cloudflare | \nhashicorp | \ndatabricks | \nclickhouse | \nsupabase | \n
| stripe | \nlaunchdarkly | \nsentry | \n\n | \n |
| 🛠️ 开发框架与工具 | ||||
| vercel | \nmicrosoft | \nexpo | \nbetter-auth | \nposit | \n
| remotion | \nslidev | \nagent-browser | \nbrowser-use | \nfirecrawl | \n
| 📝 内容与协作 | ||||
| notion | \nobsidian | \nwordpress | \ndify | \nsanity | \n
\n \n ![\"Composio](\"../assets/media/awesome-agent-skills.png\")
\n \n
| 🤖 AI Models & Platforms | ||||
|---|---|---|---|---|
| anthropics | \nopenai | \ngemini | \nhuggingface | \nreplicates | \n
| elevenlabs | \nblack-forest-labs | \n\n | \n | \n |
| ☁️ Cloud Services & Infrastructure | ||||
| cloudflare | \nhashicorp | \ndatabricks | \nclickhouse | \nsupabase | \n
| stripe | \nlaunchdarkly | \nsentry | \n\n | \n |
| 🛠️ Dev Frameworks & Tools | ||||
| vercel | \nmicrosoft | \nexpo | \nbetter-auth | \nposit | \n
| remotion | \nslidev | \nagent-browser | \nbrowser-use | \nfirecrawl | \n
| 📝 Content & Collaboration | ||||
| notion | \nobsidian | \nwordpress | \ndify | \nsanity | \n
\n \n \n \n
| 🤖 AI モデルとプラットフォーム | ||||
|---|---|---|---|---|
| anthropics | \nopenai | \ngemini | \nhuggingface | \nreplicates | \n
| elevenlabs | \nblack-forest-labs | \n\n | \n | \n |
| ☁️ クラウドサービスとインフラ | ||||
| cloudflare | \nhashicorp | \ndatabricks | \nclickhouse | \nsupabase | \n
| stripe | \nlaunchdarkly | \nsentry | \n\n | \n |
| 🛠️ 開発フレームワークとツール | ||||
| vercel | \nmicrosoft | \nexpo | \nbetter-auth | \nposit | \n
| remotion | \nslidev | \nagent-browser | \nbrowser-use | \nfirecrawl | \n
| 📝 コンテンツとコラボレーション | ||||
| notion | \nobsidian | \nwordpress | \ndify | \nsanity | \n
Current description: __SKILL_DESCRIPTION_PLACEHOLDER__
\n\n| Query | \nShould Trigger | \nActions | \n
|---|
Original: {html.escape(data.get('original_description', 'N/A'))}
\nBest: {html.escape(data.get('best_description', 'N/A'))}
\nBest Score: {data.get('best_score', 'N/A')} {'(test)' if best_test_score else '(train)'}
\nIterations: {data.get('iterations_run', 0)} | Train: {data.get('train_size', '?')} | Test: {data.get('test_size', '?')}
\n| Iter | \nTrain | \nTest | \nDescription | \n\"\"\")\n\n # Add column headers for train queries\n for qinfo in train_queries:\n polarity = \"positive-col\" if qinfo[\"should_trigger\"] else \"negative-col\"\n html_parts.append(f'{html.escape(qinfo[\"query\"])} | \\n')\n\n # Add column headers for test queries (different color)\n for qinfo in test_queries:\n polarity = \"positive-col\" if qinfo[\"should_trigger\"] else \"negative-col\"\n html_parts.append(f'{html.escape(qinfo[\"query\"])} | \\n')\n\n html_parts.append(\"\"\"
|---|---|---|---|---|---|
| {iteration} | \n{train_correct}/{train_runs} | \n{test_correct}/{test_runs} | \n{html.escape(description)} | \n\"\"\")\n\n # Add result for each train query\n for qinfo in train_queries:\n r = train_by_query.get(qinfo[\"query\"], {})\n did_pass = r.get(\"pass\", False)\n triggers = r.get(\"triggers\", 0)\n runs = r.get(\"runs\", 0)\n\n icon = \"✓\" if did_pass else \"✗\"\n css_class = \"pass\" if did_pass else \"fail\"\n\n html_parts.append(f'{icon}{triggers}/{runs} | \\n')\n\n # Add result for each test query (with different background)\n for qinfo in test_queries:\n r = test_by_query.get(qinfo[\"query\"], {})\n did_pass = r.get(\"pass\", False)\n triggers = r.get(\"triggers\", 0)\n runs = r.get(\"runs\", 0)\n\n icon = \"✓\" if did_pass else \"✗\"\n css_class = \"pass\" if did_pass else \"fail\"\n\n html_parts.append(f'{icon}{triggers}/{runs} | \\n')\n\n html_parts.append(\"
Current description: __SKILL_DESCRIPTION_PLACEHOLDER__
\n\n| Query | \nShould Trigger | \nActions | \n
|---|
Original: {html.escape(data.get('original_description', 'N/A'))}
\nBest: {html.escape(data.get('best_description', 'N/A'))}
\nBest Score: {data.get('best_score', 'N/A')} {'(test)' if best_test_score else '(train)'}
\nIterations: {data.get('iterations_run', 0)} | Train: {data.get('train_size', '?')} | Test: {data.get('test_size', '?')}
\n| Iter | \nTrain | \nTest | \nDescription | \n\"\"\")\n\n # Add column headers for train queries\n for qinfo in train_queries:\n polarity = \"positive-col\" if qinfo[\"should_trigger\"] else \"negative-col\"\n html_parts.append(f'{html.escape(qinfo[\"query\"])} | \\n')\n\n # Add column headers for test queries (different color)\n for qinfo in test_queries:\n polarity = \"positive-col\" if qinfo[\"should_trigger\"] else \"negative-col\"\n html_parts.append(f'{html.escape(qinfo[\"query\"])} | \\n')\n\n html_parts.append(\"\"\"
|---|---|---|---|---|---|
| {iteration} | \n{train_correct}/{train_runs} | \n{test_correct}/{test_runs} | \n{html.escape(description)} | \n\"\"\")\n\n # Add result for each train query\n for qinfo in train_queries:\n r = train_by_query.get(qinfo[\"query\"], {})\n did_pass = r.get(\"pass\", False)\n triggers = r.get(\"triggers\", 0)\n runs = r.get(\"runs\", 0)\n\n icon = \"✓\" if did_pass else \"✗\"\n css_class = \"pass\" if did_pass else \"fail\"\n\n html_parts.append(f'{icon}{triggers}/{runs} | \\n')\n\n # Add result for each test query (with different background)\n for qinfo in test_queries:\n r = test_by_query.get(qinfo[\"query\"], {})\n did_pass = r.get(\"pass\", False)\n triggers = r.get(\"triggers\", 0)\n runs = r.get(\"runs\", 0)\n\n icon = \"✓\" if did_pass else \"✗\"\n css_class = \"pass\" if did_pass else \"fail\"\n\n html_parts.append(f'{icon}{triggers}/{runs} | \\n')\n\n html_parts.append(\"
Current description: __SKILL_DESCRIPTION_PLACEHOLDER__
\n\n| Query | \nShould Trigger | \nActions | \n
|---|
Original: {html.escape(data.get('original_description', 'N/A'))}
\nBest: {html.escape(data.get('best_description', 'N/A'))}
\nBest Score: {data.get('best_score', 'N/A')} {'(test)' if best_test_score else '(train)'}
\nIterations: {data.get('iterations_run', 0)} | Train: {data.get('train_size', '?')} | Test: {data.get('test_size', '?')}
\n| Iter | \nTrain | \nTest | \nDescription | \n\"\"\")\n\n # Add column headers for train queries\n for qinfo in train_queries:\n polarity = \"positive-col\" if qinfo[\"should_trigger\"] else \"negative-col\"\n html_parts.append(f'{html.escape(qinfo[\"query\"])} | \\n')\n\n # Add column headers for test queries (different color)\n for qinfo in test_queries:\n polarity = \"positive-col\" if qinfo[\"should_trigger\"] else \"negative-col\"\n html_parts.append(f'{html.escape(qinfo[\"query\"])} | \\n')\n\n html_parts.append(\"\"\"
|---|---|---|---|---|---|
| {iteration} | \n{train_correct}/{train_runs} | \n{test_correct}/{test_runs} | \n{html.escape(description)} | \n\"\"\")\n\n # Add result for each train query\n for qinfo in train_queries:\n r = train_by_query.get(qinfo[\"query\"], {})\n did_pass = r.get(\"pass\", False)\n triggers = r.get(\"triggers\", 0)\n runs = r.get(\"runs\", 0)\n\n icon = \"✓\" if did_pass else \"✗\"\n css_class = \"pass\" if did_pass else \"fail\"\n\n html_parts.append(f'{icon}{triggers}/{runs} | \\n')\n\n # Add result for each test query (with different background)\n for qinfo in test_queries:\n r = test_by_query.get(qinfo[\"query\"], {})\n did_pass = r.get(\"pass\", False)\n triggers = r.get(\"triggers\", 0)\n runs = r.get(\"runs\", 0)\n\n icon = \"✓\" if did_pass else \"✗\"\n css_class = \"pass\" if did_pass else \"fail\"\n\n html_parts.append(f'{icon}{triggers}/{runs} | \\n')\n\n html_parts.append(\"
| Request | Status | Duration |
|---|---|---|
| \\(.name) | \\(.response.statusCode) | \\(.response.duration)ms |
Content...
\",\n \"totalBlocks\": 20\n}\n```\n\n## Supported Formatting\n\n| Markdown | HTML Output |\n|----------|-------------|\n| `# H1` | Title only (not in body) |\n| `## H2` - `###### H6` | `![\"Awesome\"](\"https://awesome.re/badge.svg\"){kind=icon}
\n ![\"Issues](\"https://img.shields.io/badge/Issues-welcome-brightgreen.svg?style=flat-square\"){kind=icon}
\n ![\"License:](\"https://img.shields.io/badge/License-Apache_2.0-blue.svg?style=flat-square\"){kind=icon}
\n ` |\n| `` `code` `` | `` |\n| ```` ``` ```` | `` (X limitation) |\n| `- item` | `- ` |\n| `1. item` | `
- ` |\n| `` | Image placeholder |\n\n## Workflow\n\n1. **Parse Markdown**: Extract title, cover, content images, generate HTML\n2. **Launch Chrome**: Real browser with CDP, persistent login\n3. **Navigate**: Open `x.com/compose/articles`\n4. **Create Article**: Click create button if on list page\n5. **Upload Cover**: Use file input for cover image\n6. **Fill Title**: Type title into title field\n7. **Paste Content**: Copy HTML to clipboard, paste into editor\n8. **Insert Images**: For each placeholder (reverse order):\n - Find placeholder text in editor\n - Select the placeholder\n - Copy image to clipboard\n - Paste to replace selection\n9. **Post-Composition Check** (automatic):\n - Scan editor for remaining `XIMGPH_` placeholders\n - Compare expected vs actual image count\n - Warn if issues found\n10. **Review**: Browser stays open for 60s preview\n11. **Publish**: Only with `--submit` flag\n\n## Example Session\n\n```\nUser: /post-to-x article ./blog/my-post.md --cover ./thumbnail.png\n\nClaude:\n1. Parses markdown: title=\"My Post\", 3 content images\n2. Launches Chrome with CDP\n3. Navigates to x.com/compose/articles\n4. Clicks create button\n5. Uploads thumbnail.png as cover\n6. Fills title \"My Post\"\n7. Pastes HTML content\n8. Inserts 3 images at placeholder positions\n9. Reports: \"Article composed. Review and use --submit to publish.\"\n```\n\n## Troubleshooting\n\n- **No create button**: Ensure X Premium subscription is active\n- **Cover upload fails**: Check file path and format (PNG, JPEG)\n- **Images not inserting**: Verify placeholders exist in pasted content\n- **Content not pasting**: Check HTML clipboard: `${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts html --file /tmp/test.html`\n\n## How It Works\n\n1. `md-to-html.ts` converts Markdown to HTML:\n - Extracts frontmatter (title, cover)\n - Converts markdown to HTML\n - Replaces images with unique placeholders\n - Downloads remote images locally\n - Returns structured JSON\n\n2. `x-article.ts` publishes via CDP:\n - Launches real Chrome (bypasses detection)\n - Uses persistent profile (saved login)\n - Navigates and fills editor via DOM manipulation\n - Pastes HTML from system clipboard\n - Finds/selects/replaces each image placeholder\n"
},
{
"path": "skills/obsidian-to-x/references/obsidian-conversion.md",
"content": "# Obsidian Markdown Conversion\n\nThis document explains how to convert Obsidian-specific Markdown syntax to standard Markdown for X Articles.\n\n## Problem\n\nObsidian uses non-standard Markdown syntax that requires conversion before publishing:\n- Images: `![[Attachments/image.png]]` instead of ``\n- Annotations: `> [#6178] Title` format in blockquotes\n- Frontmatter: Chinese field names like `标题:` instead of `title:`\n\n## Solution: Automatic Conversion\n\nUse the conversion script to automatically convert Obsidian syntax:\n\n```bash\n# Simple conversion (output to Temp/converted.md)\n${BUN_X} ${SKILL_DIR}/scripts/obsidian-to-article.ts Articles/your-article.md\n\n# Custom output path\n${BUN_X} ${SKILL_DIR}/scripts/obsidian-to-article.ts Articles/your-article.md Temp/custom.md\n\n# Then publish\n${BUN_X} ${SKILL_DIR}/scripts/x-article.ts Temp/converted.md\n```\n\n## What Gets Converted\n\n1. ✅ **Title**: `标题:` → `title:`\n2. ✅ **Images**: `![[Attachments/img.png]]` → ``\n3. ✅ **Placeholders**: `![[wechatAccountCard]]` → (removed)\n4. ✅ **Annotations**: `> [#6178] Title` → (removed, entire line deleted)\n5. ✅ **Callouts**: `> [!question] Title` → (removed, Obsidian callout syntax)\n6. ✅ **Cover**: `封面:` → `cover_image:` (with absolute path)\n7. ✅ **Code blocks**: Automatically extracted and inserted\n\n## Manual Conversion (Advanced)\n\nIf you prefer shell commands:\n\n```bash\n# Get current project root (assumes you're in the Obsidian project directory)\nPROJECT_ROOT=\"$(pwd)\"\nORIGINAL_FILE=\"Articles/your-article.md\"\nCONVERTED_FILE=\"Temp/converted.md\"\n\n# Create Temp directory if it doesn't exist\nmkdir -p \"$PROJECT_ROOT/Temp\"\n\n# Step 1: Convert Obsidian image syntax to standard Markdown with absolute paths\nsed \"s|!\\[\\[Attachments/\\([^|]*\\)\\(|[^]]*\\)\\{0,1\\}\\]\\]||g\" \"$ORIGINAL_FILE\" > \"$CONVERTED_FILE\"\n\n# Step 2: Remove Obsidian-specific placeholders (e.g., wechatAccountCard)\nsed -i '' '/!\\[\\[wechatAccountCard\\]\\]/d' \"$CONVERTED_FILE\"\n\n# Step 3: Remove annotation lines with [#number] prefix\nsed -i '' '/^> \\[#[0-9]*\\] /d' \"$CONVERTED_FILE\"\n\n# Step 4: Add English title field to frontmatter (extract from Chinese field)\nTITLE=$(grep \"^标题:\" \"$ORIGINAL_FILE\" | sed 's/标题: //')\nsed -i '' \"2a\\\\\ntitle: $TITLE\n\" \"$CONVERTED_FILE\"\n\n# Step 5: Extract cover image path from frontmatter\nCOVER=$(grep \"^封面:\" \"$ORIGINAL_FILE\" | sed 's/封面: \"\\[#[0-9]*\\] !\\[\\[\\(.*\\)\\]\\]\"/\\1/' | sed \"s|Attachments/|$PROJECT_ROOT/Attachments/|\")\n\n# Step 6: Publish with converted file\n${BUN_X} ${SKILL_DIR}/scripts/x-article.ts \"$CONVERTED_FILE\" --cover \"$COVER\"\n```\n\n## Simplified Version\n\nFor typical use cases:\n\n```bash\n# Quick conversion for Obsidian articles\n# Assumes you're in the project root directory\nPROJECT_ROOT=\"$(pwd)\"\nmkdir -p Temp\n\n# Convert and save to Temp directory\nsed \"s|!\\[\\[Attachments/\\([^|]*\\)\\(|[^]]*\\)\\{0,1\\}\\]\\]||g\" Articles/original.md > Temp/converted.md\nsed -i '' '/!\\[\\[wechatAccountCard\\]\\]/d' Temp/converted.md\nsed -i '' '/^> \\[#[0-9]*\\] /d' Temp/converted.md\nsed -i '' '2a\\\ntitle: Your Article Title' Temp/converted.md\n\n${BUN_X} ${SKILL_DIR}/scripts/x-article.ts Temp/converted.md --cover Attachments/cover.png\n```\n\n## When to Apply\n\nIf the user's Markdown file contains `![[]]` syntax or Chinese frontmatter, automatically perform the conversion before calling the publish script.\n"
},
{
"path": "skills/obsidian-to-x/references/obsidian-integration.md",
"content": "# Obsidian Integration\n\nThis document explains how to automatically detect and publish the currently active file in Obsidian.\n\n## Get Active File\n\n### Method 1: workspace.json (Primary, 39x faster)\n\nParse `.obsidian/workspace.json` to get the most recently opened file:\n\n```bash\n# Fast and reliable (0.007s)\nACTIVE_FILE=$(jq -r '.lastOpenFiles[0]' .obsidian/workspace.json)\n```\n\n**Advantages:**\n- ⚡ 39x faster than CLI (0.007s vs 0.274s)\n- ✅ Works even when Obsidian is not running\n- ✅ No user interaction required\n\n**Requirements:**\n- `jq` tool installed: `brew install jq` (macOS) or `apt install jq` (Linux)\n\n---\n\n### Method 2: Obsidian CLI (Fallback)\n\nUse [Obsidian CLI](https://help.obsidian.md/cli) `recents` command:\n\n```bash\n# Slower but official (0.274s)\nACTIVE_FILE=$(obsidian recents 2>&1 | grep -v \"Loading\\|installer\" | head -1)\n```\n\n**Advantages:**\n- ✅ Official Obsidian interface\n- ✅ Always up-to-date with Obsidian's state\n\n**Requirements:**\n- Obsidian 1.12+ installer\n- CLI enabled in Settings → General → Command line interface\n- Obsidian app must be running\n\n## Simplified Workflow for \"Publish Current Article\"\n\nWhen the user says \"publish current article\" or \"post this to X\":\n\n**Step 1: Get active file path**\n```bash\n# Method 1: Parse workspace.json (fast, 39x faster than CLI)\nACTIVE_FILE=$(jq -r '.lastOpenFiles[0]' .obsidian/workspace.json 2>/dev/null)\n\n# Fallback: if jq fails or file not found, use Obsidian CLI\nif [ -z \"$ACTIVE_FILE\" ] || [ ! -f \"$ACTIVE_FILE\" ]; then\n echo \"⚠️ workspace.json method failed, using Obsidian CLI fallback...\"\n ACTIVE_FILE=$(obsidian recents 2>&1 | grep -v \"Loading\\|installer\" | head -1)\nfi\n\n# Validate file exists\nif [ -z \"$ACTIVE_FILE\" ] || [ ! -f \"$ACTIVE_FILE\" ]; then\n echo \"❌ Error: Could not determine active file\"\n exit 1\nfi\n\necho \"📄 Active file: $ACTIVE_FILE\"\n```\n\n**Step 2: Clean Chrome CDP processes**\n```bash\npkill -f \"Chrome.*remote-debugging-port\" 2>/dev/null; pkill -f \"Chromium.*remote-debugging-port\" 2>/dev/null; sleep 2\n```\n\n**Step 3: Convert and publish**\n```bash\n# Convert Obsidian syntax to X format\nbun ${SKILL_DIR}/scripts/obsidian-to-article.ts \"$ACTIVE_FILE\" \"Temp/converted.md\"\n\n# Publish to X\nbun ${SKILL_DIR}/scripts/x-article.ts \"Temp/converted.md\"\n```\n\n**One-command shortcut:**\n```bash\n# Use the publish-active.sh script\nbash ${SKILL_DIR}/scripts/publish-active.sh\n```\n\n## Error Handling\n\n**If workspace.json parsing fails:**\n- Ensure `jq` is installed: `brew install jq` (macOS) or `apt install jq` (Linux)\n- Check if `.obsidian/workspace.json` exists\n- Fallback to Obsidian CLI automatically\n\n**If Obsidian CLI fallback fails:**\n- Error: \"No active file\" → Open a file in Obsidian first\n- Error: \"Obsidian CLI not found\" → Enable CLI in Settings → General → Command line interface\n- Warning: \"installer is out of date\" → Download latest installer from https://obsidian.md/download (still works, just a warning)\n"
},
{
"path": "skills/obsidian-to-x/references/regular-posts.md",
"content": "# Regular Posts - Detailed Guide\n\nDetailed documentation for posting text and images to X.\n\n## Manual Workflow\n\nIf you prefer step-by-step control:\n\n### Step 1: Copy Image to Clipboard\n\n```bash\n${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts image /path/to/image.png\n```\n\n### Step 2: Paste from Clipboard\n\n```bash\n# Simple paste to frontmost app\n${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts\n\n# Paste to Chrome with retries\n${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts --app \"Google Chrome\" --retries 5\n\n# Quick paste with shorter delay\n${BUN_X} ${SKILL_DIR}/scripts/paste-from-clipboard.ts --delay 200\n```\n\n### Step 3: Use Playwright MCP (if Chrome session available)\n\n```bash\n# Navigate\nmcp__playwright__browser_navigate url=\"https://x.com/compose/post\"\n\n# Get element refs\nmcp__playwright__browser_snapshot\n\n# Type text\nmcp__playwright__browser_click element=\"editor\" ref=\"\"\nmcp__playwright__browser_type element=\"editor\" ref=\"\" text=\"Your content\"\n\n# Paste image (after copying to clipboard)\nmcp__playwright__browser_press_key key=\"Meta+v\" # macOS\n# or\nmcp__playwright__browser_press_key key=\"Control+v\" # Windows/Linux\n\n# Screenshot to verify\nmcp__playwright__browser_take_screenshot filename=\"preview.png\"\n```\n\n## Image Support\n\n- Formats: PNG, JPEG, GIF, WebP\n- Max 4 images per post\n- Images copied to system clipboard, then pasted via keyboard shortcut\n\n## Example Session\n\n```\nUser: /post-to-x \"Hello from Claude!\" --image ./screenshot.png\n\nClaude:\n1. Runs: ${BUN_X} ${SKILL_DIR}/scripts/x-post.ts \"Hello from Claude!\" --image ./screenshot.png\n2. Chrome opens with X compose page\n3. Text is typed into editor\n4. Image is copied to clipboard and pasted\n5. Browser stays open 30s for preview\n6. Reports: \"Post composed. Use --submit to post.\"\n```\n\n## Troubleshooting\n\n- **Chrome not found**: Set `X_BROWSER_CHROME_PATH` environment variable\n- **Not logged in**: First run opens Chrome - log in manually, cookies are saved\n- **Image paste fails**:\n - Verify clipboard script: `${BUN_X} ${SKILL_DIR}/scripts/copy-to-clipboard.ts image
`\n - On macOS, grant \"Accessibility\" permission to Terminal/iTerm in System Settings > Privacy & Security > Accessibility\n - Keep Chrome window visible and in front during paste operations\n- **osascript permission denied**: Grant Terminal accessibility permissions in System Preferences\n- **Rate limited**: Wait a few minutes before retrying\n\n## How It Works\n\nThe `x-post.ts` script uses Chrome DevTools Protocol (CDP) to:\n1. Launch real Chrome (not Playwright) with `--disable-blink-features=AutomationControlled`\n2. Use persistent profile directory for saved login sessions\n3. Interact with X via CDP commands (Runtime.evaluate, Input.dispatchKeyEvent)\n4. **Paste images using osascript** (macOS): Sends real Cmd+V keystroke to Chrome, bypassing CDP's synthetic events that X can detect\n\nThis approach bypasses X's anti-automation detection that blocks Playwright/Puppeteer.\n\n### Image Paste Mechanism (macOS)\n\nCDP's `Input.dispatchKeyEvent` sends \"synthetic\" keyboard events that websites can detect. X ignores synthetic paste events for security. The solution:\n\n1. Copy image to system clipboard via Swift/AppKit (`copy-to-clipboard.ts`)\n2. Bring Chrome to front via `osascript`\n3. Send real Cmd+V keystroke via `osascript` and System Events\n4. Wait for upload to complete\n\nThis requires Terminal to have \"Accessibility\" permission in System Settings.\n"
},
{
"path": "skills/obsidian-to-x/references/troubleshooting.md",
"content": "# Troubleshooting\n\nCommon issues and solutions for the obsidian-to-x skill.\n\n## Chrome debug port not ready\n\n**Prevention (REQUIRED)**: Always clean Chrome CDP processes BEFORE executing any script:\n\n```bash\npkill -f \"Chrome.*remote-debugging-port\" 2>/dev/null; pkill -f \"Chromium.*remote-debugging-port\" 2>/dev/null; sleep 2\n```\n\n**Important**: This should be done automatically as the first step of every workflow — do not ask the user, just do it.\n\nIf a script still fails with `Chrome debug port not ready` or `Unable to connect` after cleaning, wait 5 seconds and retry once.\n\n## macOS Accessibility Permission Error\n\n**Symptom**: `osascript` fails with error 1002: \"System Events encountered an error: osascript is not allowed to send keystrokes\"\n\n**Cause**: Terminal app lacks Accessibility permissions, preventing automated paste operations for image uploads.\n\n**Fix**:\n1. Open System Settings → Privacy & Security → Accessibility\n2. Find your terminal app (Terminal.app, iTerm2, etc.)\n3. Enable the toggle to grant permission\n4. Restart the terminal and retry\n\n**Note**: The `check-paste-permissions.ts` script may show permissions as granted, but actual execution can still fail if permissions were recently changed. Always verify in System Settings if errors persist.\n\n## Post-Composition Check Failures\n\nThe script automatically verifies after all images are inserted:\n- Remaining `XIMGPH_` placeholders in editor content\n- Expected vs actual image count\n\nIf the check fails (warnings in output), alert the user with the specific issues before they publish.\n\n## Code Blocks Not Inserting\n\n**Feature**: The script automatically extracts code blocks from Markdown and inserts them into X Articles editor using CDP automation.\n\n**How it works**:\n1. Markdown parser extracts code blocks with language and content\n2. Code blocks are replaced with placeholders (`XCODEPH_1`, `XCODEPH_2`, etc.) in HTML\n3. After content and images are inserted, code blocks are inserted at placeholder positions\n4. Uses CDP `Input.insertText` and `Input.dispatchKeyEvent` for reliable insertion\n\n**Supported languages**: Any language supported by X Articles code editor (JavaScript, Python, TypeScript, Rust, Go, Shell, etc.)\n\n**Technical details**:\n- Implementation: `scripts/insert-code-blocks.ts`\n- Deletion method: `execCommand('delete')` for reliable placeholder removal\n- Insertion flow: Select placeholder → Delete → Open code dialog → Select language → Insert code\n- Total time: ~2-3 seconds per code block\n\n**No manual action required** - code blocks are automatically detected and inserted during article composition.\n"
},
{
"path": "skills/obsidian-to-x/scripts/check-editor-content.ts",
"content": "#!/usr/bin/env bun\n/**\n * 简单检查编辑器占位符\n */\n\nimport { CdpConnection, waitForChromeDebugPort } from './x-utils.js';\n\nasync function main() {\n const port = 9222;\n\n console.log('Connecting to Chrome on port', port);\n const wsUrl = await waitForChromeDebugPort(port, 5000);\n const cdp = await CdpConnection.connect(wsUrl, 5000);\n\n try {\n const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');\n const pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.includes('x.com'));\n\n if (!pageTarget) {\n console.error('No X.com page found');\n process.exit(1);\n }\n\n const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', {\n targetId: pageTarget.targetId,\n flatten: true,\n });\n\n // 获取编辑器内容\n const editorContent = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]')?.innerText || ''`,\n returnByValue: true,\n }, { sessionId });\n\n const content = editorContent.result.value;\n\n console.log('\\n=== Editor Content Analysis ===\\n');\n console.log(`Total length: ${content.length} chars\\n`);\n\n // 检查代码占位符\n const codePlaceholders = content.match(/XCODEPH_\\d+/g) || [];\n console.log(`Code placeholders remaining: ${codePlaceholders.length}`);\n if (codePlaceholders.length > 0) {\n console.log(' Found:', codePlaceholders.join(', '));\n\n // 显示每个占位符的上下文\n console.log('\\n=== Placeholder Context ===\\n');\n for (const placeholder of codePlaceholders) {\n const index = content.indexOf(placeholder);\n const before = content.substring(Math.max(0, index - 40), index);\n const after = content.substring(index + placeholder.length, Math.min(content.length, index + placeholder.length + 40));\n console.log(`${placeholder}:`);\n console.log(` ...${before}[${placeholder}]${after}...`);\n console.log('');\n }\n } else {\n console.log(' ✅ No code placeholders found - all replaced!');\n }\n\n // 检查代码块元素\n const codeBlocksCount = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelectorAll('.DraftEditor-editorContainer pre').length`,\n returnByValue: true,\n }, { sessionId });\n\n console.log(`Code blocks (pre elements): ${codeBlocksCount.result.value}`);\n\n } finally {\n await cdp.close();\n }\n}\n\nmain().catch(console.error);\n"
},
{
"path": "skills/obsidian-to-x/scripts/check-paste-permissions.ts",
"content": "import { spawnSync } from 'node:child_process';\nimport fs from 'node:fs';\nimport { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport process from 'node:process';\nimport { findChromeExecutable, CHROME_CANDIDATES_FULL, getDefaultProfileDir } from './x-utils.js';\n\ninterface CheckResult {\n name: string;\n ok: boolean;\n detail: string;\n}\n\nconst results: CheckResult[] = [];\n\nfunction log(label: string, ok: boolean, detail: string): void {\n results.push({ name: label, ok, detail });\n const icon = ok ? '✅' : '❌';\n console.log(`${icon} ${label}: ${detail}`);\n}\n\nfunction warn(label: string, detail: string): void {\n results.push({ name: label, ok: true, detail });\n console.log(`⚠️ ${label}: ${detail}`);\n}\n\nasync function checkChrome(): Promise {\n const chromePath = findChromeExecutable(CHROME_CANDIDATES_FULL);\n if (chromePath) {\n log('Chrome', true, chromePath);\n } else {\n log('Chrome', false, 'Not found. Set X_BROWSER_CHROME_PATH env var or install Chrome.');\n }\n}\n\nasync function checkProfileIsolation(): Promise {\n const profileDir = getDefaultProfileDir();\n const userChromeDir = process.platform === 'darwin'\n ? path.join(os.homedir(), 'Library', 'Application Support', 'Google', 'Chrome')\n : process.platform === 'win32'\n ? path.join(os.homedir(), 'AppData', 'Local', 'Google', 'Chrome', 'User Data')\n : path.join(os.homedir(), '.config', 'google-chrome');\n\n const isIsolated = !profileDir.startsWith(userChromeDir);\n log('Profile isolation', isIsolated, `Skill profile: ${profileDir}`);\n\n if (isIsolated) {\n const exists = fs.existsSync(profileDir);\n if (exists) {\n log('Profile dir', true, 'Exists and accessible');\n } else {\n try {\n fs.mkdirSync(profileDir, { recursive: true });\n log('Profile dir', true, 'Created successfully');\n } catch (e) {\n log('Profile dir', false, `Cannot create: ${e instanceof Error ? e.message : String(e)}`);\n }\n }\n }\n}\n\nasync function checkAccessibility(): Promise {\n if (process.platform !== 'darwin') {\n log('Accessibility', true, `Skipped (not macOS, platform: ${process.platform})`);\n return;\n }\n\n const result = spawnSync('osascript', ['-e', `\n tell application \"System Events\"\n set frontApp to name of first application process whose frontmost is true\n return frontApp\n end tell\n `], { stdio: 'pipe', timeout: 10_000 });\n\n if (result.status === 0) {\n const app = result.stdout?.toString().trim();\n log('Accessibility (System Events)', true, `Frontmost app: ${app}`);\n } else {\n const stderr = result.stderr?.toString().trim() || '';\n if (stderr.includes('not allowed assistive access') || stderr.includes('1002')) {\n log('Accessibility (System Events)', false,\n 'Denied. Grant access: System Settings → Privacy & Security → Accessibility → enable your terminal app');\n } else {\n log('Accessibility (System Events)', false, `Failed: ${stderr}`);\n }\n }\n}\n\nasync function checkClipboardCopy(): Promise {\n if (process.platform !== 'darwin') {\n log('Clipboard copy (image)', true, `Skipped (not macOS)`);\n return;\n }\n\n const tmpDir = await mkdtemp(path.join(os.tmpdir(), 'x-check-'));\n try {\n const testPng = path.join(tmpDir, 'test.png');\n const swiftSrc = `import AppKit\nimport Foundation\nlet size = NSSize(width: 2, height: 2)\nlet image = NSImage(size: size)\nimage.lockFocus()\nNSColor.red.set()\nNSBezierPath.fill(NSRect(origin: .zero, size: size))\nimage.unlockFocus()\nguard let tiff = image.tiffRepresentation,\n let rep = NSBitmapImageRep(data: tiff),\n let png = rep.representation(using: .png, properties: [:]) else {\n FileHandle.standardError.write(\"Failed to create test PNG\\\\n\".data(using: .utf8)!)\n exit(1)\n}\ntry png.write(to: URL(fileURLWithPath: CommandLine.arguments[1]))\n`;\n const genScript = path.join(tmpDir, 'gen.swift');\n await writeFile(genScript, swiftSrc, 'utf8');\n const genResult = spawnSync('swift', [genScript, testPng], { stdio: 'pipe', timeout: 30_000 });\n if (genResult.status !== 0) {\n log('Clipboard copy (image)', false, `Cannot create test image: ${genResult.stderr?.toString().trim()}`);\n return;\n }\n\n const clipSrc = `import AppKit\nimport Foundation\nguard let image = NSImage(contentsOfFile: CommandLine.arguments[1]) else {\n FileHandle.standardError.write(\"Failed to load image\\\\n\".data(using: .utf8)!)\n exit(1)\n}\nlet pb = NSPasteboard.general\npb.clearContents()\nif !pb.writeObjects([image]) {\n FileHandle.standardError.write(\"Failed to write to clipboard\\\\n\".data(using: .utf8)!)\n exit(1)\n}\n`;\n const clipScript = path.join(tmpDir, 'clip.swift');\n await writeFile(clipScript, clipSrc, 'utf8');\n const clipResult = spawnSync('swift', [clipScript, testPng], { stdio: 'pipe', timeout: 30_000 });\n if (clipResult.status === 0) {\n log('Clipboard copy (image)', true, 'Can copy image to clipboard via Swift/AppKit');\n } else {\n log('Clipboard copy (image)', false, `Failed: ${clipResult.stderr?.toString().trim()}`);\n }\n } finally {\n await rm(tmpDir, { recursive: true, force: true });\n }\n}\n\nasync function checkPasteKeystroke(): Promise {\n if (process.platform === 'darwin') {\n const result = spawnSync('osascript', ['-e', `\n tell application \"System Events\"\n -- Dry run: just check we CAN query key sending capability\n set canSend to true\n return canSend\n end tell\n `], { stdio: 'pipe', timeout: 10_000 });\n\n if (result.status === 0) {\n log('Paste keystroke (osascript)', true, 'System Events can send keystrokes');\n } else {\n const stderr = result.stderr?.toString().trim() || '';\n log('Paste keystroke (osascript)', false, `Cannot send keystrokes: ${stderr}`);\n }\n } else if (process.platform === 'linux') {\n const xdotool = spawnSync('which', ['xdotool'], { stdio: 'pipe' });\n const ydotool = spawnSync('which', ['ydotool'], { stdio: 'pipe' });\n if (xdotool.status === 0) {\n log('Paste keystroke', true, 'xdotool available (X11)');\n } else if (ydotool.status === 0) {\n log('Paste keystroke', true, 'ydotool available (Wayland)');\n } else {\n log('Paste keystroke', false, 'No tool found. Install xdotool (X11) or ydotool (Wayland).');\n }\n } else if (process.platform === 'win32') {\n log('Paste keystroke', true, 'Windows uses PowerShell SendKeys (built-in)');\n }\n}\n\nasync function checkBun(): Promise {\n const result = spawnSync('npx', ['-y', 'bun', '--version'], { stdio: 'pipe', timeout: 30_000 });\n if (result.status === 0) {\n log('Bun runtime', true, `v${result.stdout?.toString().trim()}`);\n } else {\n log('Bun runtime', false, 'Cannot run bun. Install: brew install oven-sh/bun/bun (macOS) or npm install -g bun');\n }\n}\n\nasync function checkRunningChromeConflict(): Promise {\n if (process.platform !== 'darwin') return;\n\n const result = spawnSync('pgrep', ['-f', 'Google Chrome'], { stdio: 'pipe' });\n const pids = result.stdout?.toString().trim().split('\\n').filter(Boolean) || [];\n\n if (pids.length > 0) {\n warn('Running Chrome instances', `${pids.length} Chrome process(es) detected. The skill uses --user-data-dir for isolation, so this is safe. Paste keystroke targets Chrome by app name (minor risk if multiple Chrome windows visible).`);\n } else {\n log('Running Chrome instances', true, 'No existing Chrome processes');\n }\n}\n\nasync function main(): Promise {\n console.log('=== obsidian-to-x: Permission & Environment Check ===\\n');\n\n await checkChrome();\n await checkProfileIsolation();\n await checkBun();\n await checkAccessibility();\n await checkClipboardCopy();\n await checkPasteKeystroke();\n await checkRunningChromeConflict();\n\n console.log('\\n--- Summary ---');\n const failed = results.filter((r) => !r.ok);\n if (failed.length === 0) {\n console.log('All checks passed. Ready to post to X.');\n } else {\n console.log(`${failed.length} issue(s) found:`);\n for (const f of failed) {\n console.log(` ❌ ${f.name}: ${f.detail}`);\n }\n process.exit(1);\n }\n}\n\nawait main().catch((err) => {\n console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n});\n"
},
{
"path": "skills/obsidian-to-x/scripts/copy-to-clipboard.ts",
"content": "import { spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport process from 'node:process';\n\nconst SUPPORTED_IMAGE_EXTS = new Set(['.jpg', '.jpeg', '.png', '.gif', '.webp']);\n\nfunction printUsage(exitCode = 0): never {\n console.log(`Copy image or HTML to system clipboard\n\nSupports:\n - Image files (jpg, png, gif, webp) - copies as image data\n - HTML content - copies as rich text for paste\n\nUsage:\n # Copy image to clipboard\n npx -y bun copy-to-clipboard.ts image /path/to/image.jpg\n\n # Copy HTML to clipboard\n npx -y bun copy-to-clipboard.ts html \"Hello
\"\n\n # Copy HTML from file\n npx -y bun copy-to-clipboard.ts html --file /path/to/content.html\n`);\n process.exit(exitCode);\n}\n\nfunction resolvePath(filePath: string): string {\n return path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);\n}\n\nfunction inferImageMimeType(imagePath: string): string {\n const ext = path.extname(imagePath).toLowerCase();\n switch (ext) {\n case '.jpg':\n case '.jpeg':\n return 'image/jpeg';\n case '.png':\n return 'image/png';\n case '.gif':\n return 'image/gif';\n case '.webp':\n return 'image/webp';\n default:\n return 'application/octet-stream';\n }\n}\n\ntype RunResult = { stdout: string; stderr: string; exitCode: number };\n\nasync function runCommand(\n command: string,\n args: string[],\n options?: { input?: string | Buffer; allowNonZeroExit?: boolean },\n): Promise {\n return await new Promise((resolve, reject) => {\n const child = spawn(command, args, { stdio: ['pipe', 'pipe', 'pipe'] });\n const stdoutChunks: Buffer[] = [];\n const stderrChunks: Buffer[] = [];\n\n child.stdout.on('data', (chunk) => stdoutChunks.push(Buffer.from(chunk)));\n child.stderr.on('data', (chunk) => stderrChunks.push(Buffer.from(chunk)));\n child.on('error', reject);\n child.on('close', (code) => {\n resolve({\n stdout: Buffer.concat(stdoutChunks).toString('utf8'),\n stderr: Buffer.concat(stderrChunks).toString('utf8'),\n exitCode: code ?? 0,\n });\n });\n\n if (options?.input != null) child.stdin.write(options.input);\n child.stdin.end();\n }).then((result) => {\n if (!options?.allowNonZeroExit && result.exitCode !== 0) {\n const details = result.stderr.trim() || result.stdout.trim();\n throw new Error(`Command failed (${command}): exit ${result.exitCode}${details ? `\\n${details}` : ''}`);\n }\n return result;\n });\n}\n\nasync function commandExists(command: string): Promise {\n if (process.platform === 'win32') {\n const result = await runCommand('where', [command], { allowNonZeroExit: true });\n return result.exitCode === 0 && result.stdout.trim().length > 0;\n }\n const result = await runCommand('which', [command], { allowNonZeroExit: true });\n return result.exitCode === 0 && result.stdout.trim().length > 0;\n}\n\nasync function runCommandWithFileStdin(command: string, args: string[], filePath: string): Promise {\n await new Promise((resolve, reject) => {\n const child = spawn(command, args, { stdio: ['pipe', 'pipe', 'pipe'] });\n const stderrChunks: Buffer[] = [];\n const stdoutChunks: Buffer[] = [];\n\n child.stdout.on('data', (chunk) => stdoutChunks.push(Buffer.from(chunk)));\n child.stderr.on('data', (chunk) => stderrChunks.push(Buffer.from(chunk)));\n child.on('error', reject);\n child.on('close', (code) => {\n const exitCode = code ?? 0;\n if (exitCode !== 0) {\n const details = Buffer.concat(stderrChunks).toString('utf8').trim() || Buffer.concat(stdoutChunks).toString('utf8').trim();\n reject(\n new Error(`Command failed (${command}): exit ${exitCode}${details ? `\\n${details}` : ''}`),\n );\n return;\n }\n resolve();\n });\n\n fs.createReadStream(filePath).on('error', reject).pipe(child.stdin);\n });\n}\n\nasync function withTempDir(prefix: string, fn: (tempDir: string) => Promise): Promise {\n const tempDir = await mkdtemp(path.join(os.tmpdir(), prefix));\n try {\n return await fn(tempDir);\n } finally {\n await rm(tempDir, { recursive: true, force: true });\n }\n}\n\nfunction getMacSwiftClipboardSource(): string {\n return `import AppKit\nimport Foundation\n\nfunc die(_ message: String, _ code: Int32 = 1) -> Never {\n FileHandle.standardError.write(message.data(using: .utf8)!)\n exit(code)\n}\n\nif CommandLine.arguments.count < 3 {\n die(\"Usage: clipboard.swift \\\\n\")\n}\n\nlet mode = CommandLine.arguments[1]\nlet inputPath = CommandLine.arguments[2]\nlet pasteboard = NSPasteboard.general\npasteboard.clearContents()\n\nswitch mode {\ncase \"image\":\n guard let image = NSImage(contentsOfFile: inputPath) else {\n die(\"Failed to load image: \\\\(inputPath)\\\\n\")\n }\n if !pasteboard.writeObjects([image]) {\n die(\"Failed to write image to clipboard\\\\n\")\n }\n\ncase \"html\":\n let url = URL(fileURLWithPath: inputPath)\n let data: Data\n do {\n data = try Data(contentsOf: url)\n } catch {\n die(\"Failed to read HTML file: \\\\(inputPath)\\\\n\")\n }\n\n _ = pasteboard.setData(data, forType: .html)\n\n let options: [NSAttributedString.DocumentReadingOptionKey: Any] = [\n .documentType: NSAttributedString.DocumentType.html,\n .characterEncoding: String.Encoding.utf8.rawValue\n ]\n\n if let attr = try? NSAttributedString(data: data, options: options, documentAttributes: nil) {\n pasteboard.setString(attr.string, forType: .string)\n if let rtf = try? attr.data(\n from: NSRange(location: 0, length: attr.length),\n documentAttributes: [.documentType: NSAttributedString.DocumentType.rtf]\n ) {\n _ = pasteboard.setData(rtf, forType: .rtf)\n }\n } else if let html = String(data: data, encoding: .utf8) {\n pasteboard.setString(html, forType: .string)\n }\n\ndefault:\n die(\"Unknown mode: \\\\(mode)\\\\n\")\n}\n`;\n}\n\nasync function copyImageMac(imagePath: string): Promise {\n await withTempDir('copy-to-clipboard-', async (tempDir) => {\n const swiftPath = path.join(tempDir, 'clipboard.swift');\n await writeFile(swiftPath, getMacSwiftClipboardSource(), 'utf8');\n await runCommand('swift', [swiftPath, 'image', imagePath]);\n });\n}\n\nasync function copyHtmlMac(htmlFilePath: string): Promise {\n await withTempDir('copy-to-clipboard-', async (tempDir) => {\n const swiftPath = path.join(tempDir, 'clipboard.swift');\n await writeFile(swiftPath, getMacSwiftClipboardSource(), 'utf8');\n await runCommand('swift', [swiftPath, 'html', htmlFilePath]);\n });\n}\n\nasync function copyImageLinux(imagePath: string): Promise {\n const mime = inferImageMimeType(imagePath);\n if (await commandExists('wl-copy')) {\n await runCommandWithFileStdin('wl-copy', ['--type', mime], imagePath);\n return;\n }\n if (await commandExists('xclip')) {\n await runCommand('xclip', ['-selection', 'clipboard', '-t', mime, '-i', imagePath]);\n return;\n }\n throw new Error('No clipboard tool found. Install `wl-clipboard` (wl-copy) or `xclip`.');\n}\n\nasync function copyHtmlLinux(htmlFilePath: string): Promise {\n if (await commandExists('wl-copy')) {\n await runCommandWithFileStdin('wl-copy', ['--type', 'text/html'], htmlFilePath);\n return;\n }\n if (await commandExists('xclip')) {\n await runCommand('xclip', ['-selection', 'clipboard', '-t', 'text/html', '-i', htmlFilePath]);\n return;\n }\n throw new Error('No clipboard tool found. Install `wl-clipboard` (wl-copy) or `xclip`.');\n}\n\nasync function copyImageWindows(imagePath: string): Promise {\n const escaped = imagePath.replace(/'/g, \"''\");\n const ps = [\n 'Add-Type -AssemblyName System.Windows.Forms',\n 'Add-Type -AssemblyName System.Drawing',\n `$img = [System.Drawing.Image]::FromFile('${escaped}')`,\n '[System.Windows.Forms.Clipboard]::SetImage($img)',\n '$img.Dispose()',\n ].join('; ');\n await runCommand('powershell.exe', ['-NoProfile', '-Sta', '-Command', ps]);\n}\n\nasync function copyHtmlWindows(htmlFilePath: string): Promise {\n const escaped = htmlFilePath.replace(/'/g, \"''\");\n const ps = [\n 'Add-Type -AssemblyName System.Windows.Forms',\n `$html = Get-Content -Raw -LiteralPath '${escaped}'`,\n '[System.Windows.Forms.Clipboard]::SetText($html, [System.Windows.Forms.TextDataFormat]::Html)',\n ].join('; ');\n await runCommand('powershell.exe', ['-NoProfile', '-Sta', '-Command', ps]);\n}\n\nasync function copyImageToClipboard(imagePathInput: string): Promise {\n const imagePath = resolvePath(imagePathInput);\n const ext = path.extname(imagePath).toLowerCase();\n if (!SUPPORTED_IMAGE_EXTS.has(ext)) {\n throw new Error(\n `Unsupported image type: ${ext || '(none)'} (supported: ${Array.from(SUPPORTED_IMAGE_EXTS).join(', ')})`,\n );\n }\n if (!fs.existsSync(imagePath)) throw new Error(`File not found: ${imagePath}`);\n\n switch (process.platform) {\n case 'darwin':\n await copyImageMac(imagePath);\n return;\n case 'linux':\n await copyImageLinux(imagePath);\n return;\n case 'win32':\n await copyImageWindows(imagePath);\n return;\n default:\n throw new Error(`Unsupported platform: ${process.platform}`);\n }\n}\n\nasync function copyHtmlFileToClipboard(htmlFilePathInput: string): Promise {\n const htmlFilePath = resolvePath(htmlFilePathInput);\n if (!fs.existsSync(htmlFilePath)) throw new Error(`File not found: ${htmlFilePath}`);\n\n switch (process.platform) {\n case 'darwin':\n await copyHtmlMac(htmlFilePath);\n return;\n case 'linux':\n await copyHtmlLinux(htmlFilePath);\n return;\n case 'win32':\n await copyHtmlWindows(htmlFilePath);\n return;\n default:\n throw new Error(`Unsupported platform: ${process.platform}`);\n }\n}\n\nasync function readStdinText(): Promise {\n if (process.stdin.isTTY) return null;\n const chunks: Buffer[] = [];\n for await (const chunk of process.stdin) {\n chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n }\n const text = Buffer.concat(chunks).toString('utf8');\n return text.length > 0 ? text : null;\n}\n\nasync function copyHtmlToClipboard(args: string[]): Promise {\n let htmlFile: string | undefined;\n const positional: string[] = [];\n\n for (let i = 0; i < args.length; i += 1) {\n const arg = args[i] ?? '';\n if (arg === '--help' || arg === '-h') printUsage(0);\n if (arg === '--file') {\n htmlFile = args[i + 1];\n i += 1;\n continue;\n }\n if (arg.startsWith('--file=')) {\n htmlFile = arg.slice('--file='.length);\n continue;\n }\n if (arg === '--') {\n positional.push(...args.slice(i + 1));\n break;\n }\n if (arg.startsWith('-')) {\n throw new Error(`Unknown option: ${arg}`);\n }\n positional.push(arg);\n }\n\n if (htmlFile && positional.length > 0) {\n throw new Error('Do not pass HTML text when using --file.');\n }\n\n if (htmlFile) {\n await copyHtmlFileToClipboard(htmlFile);\n return;\n }\n\n const htmlFromArgs = positional.join(' ').trim();\n const htmlFromStdin = (await readStdinText())?.trim() ?? '';\n const html = htmlFromArgs || htmlFromStdin;\n if (!html) throw new Error('Missing HTML input. Provide a string or use --file.');\n\n await withTempDir('copy-to-clipboard-', async (tempDir) => {\n const htmlPath = path.join(tempDir, 'input.html');\n await writeFile(htmlPath, html, 'utf8');\n await copyHtmlFileToClipboard(htmlPath);\n });\n}\n\nasync function main(): Promise {\n const argv = process.argv.slice(2);\n if (argv.length === 0) printUsage(1);\n\n const command = argv[0];\n if (command === '--help' || command === '-h') printUsage(0);\n\n if (command === 'image') {\n const imagePath = argv[1];\n if (!imagePath) throw new Error('Missing image path.');\n await copyImageToClipboard(imagePath);\n return;\n }\n\n if (command === 'html') {\n await copyHtmlToClipboard(argv.slice(1));\n return;\n }\n\n throw new Error(`Unknown command: ${command}`);\n}\n\nawait main().catch((err) => {\n const message = err instanceof Error ? err.message : String(err);\n console.error(`Error: ${message}`);\n process.exit(1);\n});\n\n"
},
{
"path": "skills/obsidian-to-x/scripts/insert-code-blocks.ts",
"content": "import type { CdpConnection } from './x-utils.js';\n\ninterface CodeBlockInfo {\n placeholder: string;\n language: string;\n code: string;\n blockIndex: number;\n}\n\nconst sleep = (ms: number) => new Promise(resolve => setTimeout(resolve, ms));\n\n/**\n * 在 X Articles 编辑器中插入单个代码块\n */\nasync function insertSingleCodeBlock(\n cdp: CdpConnection,\n sessionId: string,\n language: string,\n code: string,\n): Promise {\n // 1. 点击 Add Media 按钮\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('button[aria-label=\"Add Media\"]')?.click()`,\n }, { sessionId });\n await sleep(300);\n\n // 2. 点击 Code 菜单项\n await cdp.send('Runtime.evaluate', {\n expression: `Array.from(document.querySelectorAll('[role=\"menuitem\"]')).find(el => el.textContent.trim() === 'Code')?.click()`,\n }, { sessionId });\n await sleep(300);\n\n // 3. 聚焦语言输入框\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('input')?.focus()`,\n }, { sessionId });\n await sleep(100);\n\n // 4. 输入语言名称（首字母大写）\n const capitalizedLanguage = language.charAt(0).toUpperCase() + language.slice(1).toLowerCase();\n await cdp.send('Input.insertText', {\n text: capitalizedLanguage,\n }, { sessionId });\n await sleep(300);\n\n // 5. 按 ArrowDown 选中第一个选项\n await cdp.send('Input.dispatchKeyEvent', {\n type: 'keyDown',\n key: 'ArrowDown',\n code: 'ArrowDown',\n windowsVirtualKeyCode: 40,\n }, { sessionId });\n await cdp.send('Input.dispatchKeyEvent', {\n type: 'keyUp',\n key: 'ArrowDown',\n code: 'ArrowDown',\n windowsVirtualKeyCode: 40,\n }, { sessionId });\n\n // 6. 按 Enter 确认选择\n await cdp.send('Input.dispatchKeyEvent', {\n type: 'keyDown',\n key: 'Enter',\n code: 'Enter',\n windowsVirtualKeyCode: 13,\n }, { sessionId });\n await cdp.send('Input.dispatchKeyEvent', {\n type: 'keyUp',\n key: 'Enter',\n code: 'Enter',\n windowsVirtualKeyCode: 13,\n }, { sessionId });\n await sleep(200);\n\n // 7. 聚焦代码输入框\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('textarea')?.focus()`,\n }, { sessionId });\n await sleep(100);\n\n // 8. 输入代码内容\n await cdp.send('Input.insertText', {\n text: code,\n }, { sessionId });\n await sleep(200);\n\n // 9. 点击 Insert 按钮\n await cdp.send('Runtime.evaluate', {\n expression: `Array.from(document.querySelectorAll('button')).find(btn => btn.textContent.trim() === 'Insert')?.click()`,\n }, { sessionId });\n await sleep(500);\n}\n\n/**\n * 插入所有代码块（替换占位符）\n */\nexport async function insertCodeBlocks(\n cdp: CdpConnection,\n sessionId: string,\n codeBlocks: CodeBlockInfo[],\n): Promise {\n if (codeBlocks.length === 0) {\n return;\n }\n\n console.log(`[insert-code] Inserting ${codeBlocks.length} code blocks...`);\n\n // 检查编辑器中的占位符\n const editorContent = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]')?.innerText || ''`,\n returnByValue: true,\n }, { sessionId });\n\n console.log('[insert-code] Checking for code placeholders in content...');\n for (const block of codeBlocks) {\n const regex = new RegExp(block.placeholder + '(?!\\\\d)');\n if (regex.test(editorContent.result.value)) {\n console.log(`[insert-code] Found: ${block.placeholder}`);\n } else {\n console.log(`[insert-code] NOT found: ${block.placeholder}`);\n }\n }\n\n // 按占位符顺序处理代码块\n const getPlaceholderIndex = (placeholder: string): number => {\n const match = placeholder.match(/XCODEPH_(\\d+)/);\n return match ? Number(match[1]) : Number.POSITIVE_INFINITY;\n };\n const sortedCodeBlocks = [...codeBlocks].sort(\n (a, b) => getPlaceholderIndex(a.placeholder) - getPlaceholderIndex(b.placeholder),\n );\n\n for (let i = 0; i < sortedCodeBlocks.length; i++) {\n const block = sortedCodeBlocks[i]!;\n console.log(`[insert-code] [${i + 1}/${sortedCodeBlocks.length}] Inserting code at placeholder: ${block.placeholder}`);\n\n // 选择占位符\n const selectPlaceholder = async (maxRetries = 3): Promise => {\n for (let attempt = 1; attempt <= maxRetries; attempt++) {\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]');\n if (!editor) return false;\n\n const placeholder = ${JSON.stringify(block.placeholder)};\n const walker = document.createTreeWalker(editor, NodeFilter.SHOW_TEXT, null, false);\n let node;\n\n while ((node = walker.nextNode())) {\n const text = node.textContent || '';\n let searchStart = 0;\n let idx;\n\n while ((idx = text.indexOf(placeholder, searchStart)) !== -1) {\n const afterIdx = idx + placeholder.length;\n const charAfter = text[afterIdx];\n\n if (charAfter === undefined || !/\\\\d/.test(charAfter)) {\n const parentElement = node.parentElement;\n if (parentElement) {\n parentElement.scrollIntoView({ behavior: 'smooth', block: 'center' });\n }\n\n const range = document.createRange();\n range.setStart(node, idx);\n range.setEnd(node, idx + placeholder.length);\n const sel = window.getSelection();\n sel.removeAllRanges();\n sel.addRange(range);\n return true;\n }\n searchStart = afterIdx;\n }\n }\n return false;\n })()`,\n }, { sessionId });\n\n await sleep(800);\n\n // 验证选择\n const selectionCheck = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `window.getSelection()?.toString() || ''`,\n returnByValue: true,\n }, { sessionId });\n\n const selectedText = selectionCheck.result.value.trim();\n if (selectedText === block.placeholder) {\n console.log(`[insert-code] Selection verified: \"${selectedText}\"`);\n return true;\n }\n\n if (attempt < maxRetries) {\n console.log(`[insert-code] Selection attempt ${attempt} got \"${selectedText}\", retrying...`);\n await sleep(500);\n } else {\n console.warn(`[insert-code] Selection failed after ${maxRetries} attempts, got: \"${selectedText}\"`);\n }\n }\n return false;\n };\n\n const selected = await selectPlaceholder(3);\n if (!selected) {\n console.warn(`[insert-code] Skipping code block - could not select placeholder: ${block.placeholder}`);\n continue;\n }\n\n console.log(`[insert-code] Inserting ${block.language} code (${block.code.length} chars)`);\n\n // 删除占位符（使用 execCommand，比键盘事件更可靠）\n console.log(`[insert-code] Deleting placeholder...`);\n const deleteResult = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => {\n const sel = window.getSelection();\n if (!sel || sel.isCollapsed) return false;\n // Try execCommand delete first\n if (document.execCommand('delete', false)) return true;\n // Fallback: replace selection with empty using insertText\n document.execCommand('insertText', false, '');\n return true;\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n await sleep(500);\n\n // 验证占位符已删除\n const afterDelete = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]');\n if (!editor) return true;\n const text = editor.innerText;\n const placeholder = ${JSON.stringify(block.placeholder)};\n const regex = new RegExp(placeholder + '(?!\\\\\\\\d)');\n return !regex.test(text);\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n if (!afterDelete.result.value) {\n console.warn(`[insert-code] Placeholder still exists, retrying deletion...`);\n // 重试：重新选择并使用多种方法删除\n const reselected = await selectPlaceholder(2);\n if (reselected) {\n await sleep(300);\n // 尝试多种删除方法\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const sel = window.getSelection();\n if (!sel || sel.isCollapsed) return false;\n\n // 方法1: execCommand delete\n if (document.execCommand('delete', false)) {\n return true;\n }\n\n // 方法2: insertText 空字符串\n if (document.execCommand('insertText', false, '')) {\n return true;\n }\n\n // 方法3: 直接操作 DOM (最后手段)\n try {\n const range = sel.getRangeAt(0);\n range.deleteContents();\n return true;\n } catch (e) {\n return false;\n }\n })()`,\n }, { sessionId });\n await sleep(800);\n\n // 再次验证\n const finalCheck = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]');\n if (!editor) return true;\n const text = editor.innerText;\n const placeholder = ${JSON.stringify(block.placeholder)};\n const regex = new RegExp(placeholder + '(?!\\\\\\\\\\\\\\\\d)');\n return !regex.test(text);\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n if (!finalCheck.result.value) {\n console.error(`[insert-code] ❌ Failed to delete placeholder after retry: ${block.placeholder}`);\n console.error(`[insert-code] Skipping this code block to avoid duplication`);\n continue;\n } else {\n console.log(`[insert-code] ✓ Placeholder deleted successfully on retry`);\n }\n } else {\n console.error(`[insert-code] ❌ Could not reselect placeholder, skipping: ${block.placeholder}`);\n continue;\n }\n }\n\n // 插入代码块\n await insertSingleCodeBlock(cdp, sessionId, block.language, block.code);\n\n console.log(`[insert-code] Code block ${i + 1}/${sortedCodeBlocks.length} inserted`);\n }\n\n console.log('[insert-code] All code blocks inserted successfully');\n}\n"
},
{
"path": "skills/obsidian-to-x/scripts/md-to-html.ts",
"content": "import fs from 'node:fs';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport https from 'node:https';\nimport os from 'node:os';\nimport path from 'node:path';\nimport process from 'node:process';\nimport { createHash } from 'node:crypto';\n\nimport frontMatter from 'front-matter';\nimport hljs from 'highlight.js/lib/common';\nimport { Lexer, Marked, type RendererObject, type Tokens } from 'marked';\nimport { unified } from 'unified';\nimport remarkCjkFriendly from 'remark-cjk-friendly';\nimport remarkParse from 'remark-parse';\nimport remarkStringify from 'remark-stringify';\n\ninterface ImageInfo {\n placeholder: string;\n localPath: string;\n originalPath: string;\n blockIndex: number;\n}\n\ninterface CodeBlockInfo {\n placeholder: string;\n language: string;\n code: string;\n blockIndex: number;\n}\n\ninterface ParsedMarkdown {\n title: string;\n coverImage: string | null;\n contentImages: ImageInfo[];\n codeBlocks: CodeBlockInfo[];\n html: string;\n totalBlocks: number;\n}\n\ntype FrontmatterFields = Record;\n\nfunction parseFrontmatter(content: string): { frontmatter: FrontmatterFields; body: string } {\n try {\n const parsed = frontMatter(content);\n return {\n frontmatter: parsed.attributes ?? {},\n body: parsed.body,\n };\n } catch {\n return { frontmatter: {}, body: content };\n }\n}\n\nfunction stripWrappingQuotes(value: string): string {\n if (!value) return value;\n const doubleQuoted = value.startsWith('\"') && value.endsWith('\"');\n const singleQuoted = value.startsWith(\"'\") && value.endsWith(\"'\");\n const cjkDoubleQuoted = value.startsWith('\\u201c') && value.endsWith('\\u201d');\n const cjkSingleQuoted = value.startsWith('\\u2018') && value.endsWith('\\u2019');\n if (doubleQuoted || singleQuoted || cjkDoubleQuoted || cjkSingleQuoted) {\n return value.slice(1, -1).trim();\n }\n return value.trim();\n}\n\nfunction toFrontmatterString(value: unknown): string | undefined {\n if (typeof value === 'string') {\n return stripWrappingQuotes(value);\n }\n if (typeof value === 'number' || typeof value === 'boolean') {\n return String(value);\n }\n return undefined;\n}\n\nfunction pickFirstString(frontmatter: FrontmatterFields, keys: string[]): string | undefined {\n for (const key of keys) {\n const value = toFrontmatterString(frontmatter[key]);\n if (value) return value;\n }\n return undefined;\n}\n\nfunction findCoverImageNearMarkdown(baseDir: string): string | null {\n const candidateDirs = [baseDir, path.join(baseDir, 'imgs')];\n const coverPattern = /^cover\\.(png|jpe?g|webp)$/i;\n\n for (const dir of candidateDirs) {\n try {\n if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {\n continue;\n }\n\n const match = fs.readdirSync(dir).find((entry) => coverPattern.test(entry));\n if (match) {\n return path.join(dir, match);\n }\n } catch {\n continue;\n }\n }\n\n return null;\n}\n\nfunction extractTitleFromMarkdown(markdown: string): string {\n const tokens = Lexer.lex(markdown, { gfm: true, breaks: true });\n for (const token of tokens) {\n if (token.type === 'heading' && token.depth === 1) {\n return stripWrappingQuotes(token.text);\n }\n }\n return '';\n}\n\nfunction downloadFile(url: string, destPath: string, maxRedirects = 5): Promise {\n return new Promise((resolve, reject) => {\n if (!url.startsWith('https://')) {\n reject(new Error(`Refusing non-HTTPS download: ${url}`));\n return;\n }\n if (maxRedirects <= 0) {\n reject(new Error('Too many redirects'));\n return;\n }\n const file = fs.createWriteStream(destPath);\n\n const request = https.get(url, { headers: { 'User-Agent': 'Mozilla/5.0' } }, (response) => {\n if (response.statusCode === 301 || response.statusCode === 302) {\n const redirectUrl = response.headers.location;\n if (redirectUrl) {\n file.close();\n fs.unlinkSync(destPath);\n downloadFile(redirectUrl, destPath, maxRedirects - 1).then(resolve).catch(reject);\n return;\n }\n }\n\n if (response.statusCode !== 200) {\n file.close();\n fs.unlinkSync(destPath);\n reject(new Error(`Failed to download: ${response.statusCode}`));\n return;\n }\n\n response.pipe(file);\n file.on('finish', () => {\n file.close();\n resolve();\n });\n });\n\n request.on('error', (err) => {\n file.close();\n fs.unlink(destPath, () => {});\n reject(err);\n });\n\n request.setTimeout(30000, () => {\n request.destroy();\n reject(new Error('Download timeout'));\n });\n });\n}\n\nfunction getImageExtension(urlOrPath: string): string {\n const match = urlOrPath.match(/\\.(jpg|jpeg|png|gif|webp)(\\?|$)/i);\n return match ? match[1]!.toLowerCase() : 'png';\n}\n\nasync function resolveImagePath(imagePath: string, baseDir: string, tempDir: string): Promise {\n if (imagePath.startsWith('http://')) {\n console.error(`[md-to-html] Skipping non-HTTPS image: ${imagePath}`);\n return '';\n }\n if (imagePath.startsWith('https://')) {\n const hash = createHash('md5').update(imagePath).digest('hex').slice(0, 8);\n const ext = getImageExtension(imagePath);\n const localPath = path.join(tempDir, `remote_${hash}.${ext}`);\n\n if (!fs.existsSync(localPath)) {\n console.error(`[md-to-html] Downloading: ${imagePath}`);\n await downloadFile(imagePath, localPath);\n }\n return localPath;\n }\n\n if (path.isAbsolute(imagePath)) {\n return imagePath;\n }\n\n return path.resolve(baseDir, imagePath);\n}\n\nfunction escapeHtml(text: string): string {\n return text\n .replace(/&/g, '&')\n .replace(//g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\nfunction escapeHtml(text: string): string {\n return text\n .replace(/&/g, '&')\n .replace(//g, '>')\n .replace(/\"/g, '"')\n .replace(/'/g, ''');\n}\n\nfunction preprocessCjkMarkdown(markdown: string): string {\n try {\n const processor = unified()\n .use(remarkParse)\n .use(remarkCjkFriendly)\n .use(remarkStringify);\n\n const result = String(processor.processSync(markdown));\n return result.replace(/&#x([0-9A-Fa-f]+);/g, (_, hex: string) => String.fromCodePoint(parseInt(hex, 16)));\n } catch {\n return markdown;\n }\n}\n\nfunction convertMarkdownToHtml(\n markdown: string,\n imageCallback: (src: string, alt: string) => string,\n codeBlockCallback: (lang: string, code: string) => string\n): { html: string; totalBlocks: number } {\n const preprocessedMarkdown = preprocessCjkMarkdown(markdown);\n const blockTokens = Lexer.lex(preprocessedMarkdown, { gfm: true, breaks: true });\n\n const renderer: RendererObject = {\n heading({ depth, tokens }: Tokens.Heading): string {\n if (depth === 1) {\n return '';\n }\n return `${this.parser.parseInline(tokens)}
`;\n },\n\n paragraph({ tokens }: Tokens.Paragraph): string {\n const text = this.parser.parseInline(tokens).trim();\n if (!text) return '';\n return `${text}
`;\n },\n\n blockquote({ tokens }: Tokens.Blockquote): string {\n // 处理 annotation 格式：[#数字] 标题\n // 检查第一个段落的第一行是否以 [#数字] 开头\n if (tokens.length > 0 && tokens[0]?.type === 'paragraph') {\n const firstPara = tokens[0] as Tokens.Paragraph;\n if (firstPara.tokens && firstPara.tokens.length > 0) {\n const firstToken = firstPara.tokens[0];\n if (firstToken?.type === 'text') {\n const textToken = firstToken as Tokens.Text;\n // 匹配 [#数字] 后面的内容（可能是完整标题，也可能只是标题的一部分）\n const match = textToken.text.match(/^\\[#\\d+\\]\\s+(.*)$/);\n if (match) {\n // 找到 annotation 格式\n const titleText = match[1]?.trim();\n if (titleText) {\n // 替换为粗体格式\n textToken.text = `**${titleText}**`;\n } else {\n // 如果标记后没有文本，删除整个 token\n firstPara.tokens.shift();\n }\n }\n }\n }\n }\n return `${this.parser.parse(tokens)}
`;\n },\n\n code({ text, lang = '' }: Tokens.Code): string {\n const language = lang.split(/\\s+/)[0]!.toLowerCase();\n const source = text.replace(/\\n$/, '');\n\n // 使用占位符代替直接渲染 HTML\n return codeBlockCallback(language, source);\n },\n\n image({ href, text }: Tokens.Image): string {\n if (!href) return '';\n return imageCallback(href, text ?? '');\n },\n\n link({ href, title, tokens, text }: Tokens.Link): string {\n const label = tokens?.length ? this.parser.parseInline(tokens) : escapeHtml(text || href || '');\n if (!href) return label;\n\n const titleAttr = title ? ` title=\"${escapeHtml(title)}\"` : '';\n return `${label}`;\n },\n };\n\n const parser = new Marked({\n gfm: true,\n breaks: true,\n });\n parser.use({ renderer });\n\n const rendered = parser.parse(preprocessedMarkdown);\n if (typeof rendered !== 'string') {\n throw new Error('Unexpected async markdown parse result');\n }\n\n const totalBlocks = blockTokens.filter((token) => {\n if (token.type === 'space') return false;\n if (token.type === 'heading' && token.depth === 1) return false;\n return true;\n }).length;\n\n return {\n html: rendered,\n totalBlocks,\n };\n}\n\nexport async function parseMarkdown(\n markdownPath: string,\n options?: { coverImage?: string; title?: string; tempDir?: string },\n): Promise {\n const content = fs.readFileSync(markdownPath, 'utf-8');\n const baseDir = path.dirname(markdownPath);\n const tempDir = options?.tempDir ?? path.join(os.tmpdir(), 'x-article-images');\n\n await mkdir(tempDir, { recursive: true });\n\n const { frontmatter, body } = parseFrontmatter(content);\n\n let title = stripWrappingQuotes(options?.title ?? '') || pickFirstString(frontmatter, ['title']) || '';\n if (!title) {\n title = extractTitleFromMarkdown(body);\n }\n if (!title) {\n title = path.basename(markdownPath, path.extname(markdownPath));\n }\n\n let coverImagePath = stripWrappingQuotes(options?.coverImage ?? '') || pickFirstString(frontmatter, [\n 'cover_image',\n 'coverImage',\n 'cover',\n 'image',\n 'featureImage',\n 'feature_image',\n ]) || null;\n if (!coverImagePath) {\n coverImagePath = findCoverImageNearMarkdown(baseDir);\n }\n\n const images: Array<{ src: string; alt: string; blockIndex: number }> = [];\n let imageCounter = 0;\n const codeBlocks: CodeBlockInfo[] = [];\n let codeBlockCounter = 0;\n\n const { html, totalBlocks } = convertMarkdownToHtml(\n body,\n (src, alt) => {\n const placeholder = `XIMGPH_${++imageCounter}`;\n images.push({ src, alt, blockIndex: -1 });\n return placeholder;\n },\n (lang, code) => {\n const placeholder = `XCODEPH_${++codeBlockCounter}`;\n codeBlocks.push({ placeholder, language: lang, code, blockIndex: -1 });\n return placeholder;\n }\n );\n\n const htmlLines = html.split('\\n');\n for (let i = 0; i < images.length; i++) {\n const placeholder = `XIMGPH_${i + 1}`;\n for (let lineIndex = 0; lineIndex < htmlLines.length; lineIndex++) {\n const regex = new RegExp(`\\\\b${placeholder}\\\\b`);\n if (regex.test(htmlLines[lineIndex]!)) {\n images[i]!.blockIndex = lineIndex;\n break;\n }\n }\n }\n\n const contentImages: ImageInfo[] = [];\n let firstImageAsCover: string | null = null;\n\n for (let i = 0; i < images.length; i++) {\n const img = images[i]!;\n const localPath = await resolveImagePath(img.src, baseDir, tempDir);\n\n if (i === 0 && !coverImagePath) {\n firstImageAsCover = localPath;\n }\n\n contentImages.push({\n placeholder: `XIMGPH_${i + 1}`,\n localPath,\n originalPath: img.src,\n blockIndex: img.blockIndex,\n });\n }\n\n const finalHtml = html.replace(/\\n{3,}/g, '\\n\\n').trim();\n\n let resolvedCoverImage: string | null = null;\n if (coverImagePath) {\n resolvedCoverImage = await resolveImagePath(coverImagePath, baseDir, tempDir);\n } else if (firstImageAsCover) {\n resolvedCoverImage = firstImageAsCover;\n }\n\n return {\n title,\n coverImage: resolvedCoverImage,\n contentImages,\n codeBlocks,\n html: finalHtml,\n totalBlocks,\n };\n}\n\nfunction printUsage(): never {\n console.log(`Convert Markdown to HTML for X Article publishing\n\nUsage:\n npx -y bun md-to-html.ts [options]\n\nOptions:\n --title Override title from frontmatter\n --cover <image> Override cover image from frontmatter\n --output <json|html> Output format (default: json)\n --html-only Output only the HTML content\n --save-html <path> Save HTML to file\n\nFrontmatter fields:\n title: Article title (or use first H1)\n cover_image: Cover image path or URL\n cover: Alias for cover_image\n image: Alias for cover_image\n\nExample:\n npx -y bun md-to-html.ts article.md --output json\n npx -y bun md-to-html.ts article.md --html-only > /tmp/article.html\n npx -y bun md-to-html.ts article.md --save-html /tmp/article.html\n`);\n process.exit(0);\n}\n\nasync function main(): Promise<void> {\n const args = process.argv.slice(2);\n if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\n printUsage();\n }\n\n let markdownPath: string | undefined;\n let title: string | undefined;\n let coverImage: string | undefined;\n let outputFormat: 'json' | 'html' = 'json';\n let htmlOnly = false;\n let saveHtmlPath: string | undefined;\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i]!;\n if (arg === '--title' && args[i + 1]) {\n title = args[++i];\n } else if (arg === '--cover' && args[i + 1]) {\n coverImage = args[++i];\n } else if (arg === '--output' && args[i + 1]) {\n outputFormat = args[++i] as 'json' | 'html';\n } else if (arg === '--html-only') {\n htmlOnly = true;\n } else if (arg === '--save-html' && args[i + 1]) {\n saveHtmlPath = args[++i];\n } else if (!arg.startsWith('-')) {\n markdownPath = arg;\n }\n }\n\n if (!markdownPath) {\n console.error('Error: Markdown file path required');\n process.exit(1);\n }\n\n if (!fs.existsSync(markdownPath)) {\n console.error(`Error: File not found: ${markdownPath}`);\n process.exit(1);\n }\n\n const result = await parseMarkdown(markdownPath, { title, coverImage });\n\n if (saveHtmlPath) {\n await writeFile(saveHtmlPath, result.html, 'utf-8');\n console.error(`[md-to-html] HTML saved to: ${saveHtmlPath}`);\n }\n\n if (htmlOnly) {\n console.log(result.html);\n } else if (outputFormat === 'html') {\n console.log(result.html);\n } else {\n console.log(JSON.stringify(result, null, 2));\n }\n}\n\nawait main().catch((err) => {\n console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n});\n"
},
{
"path": "skills/obsidian-to-x/scripts/obsidian-to-article.ts",
"content": "#!/usr/bin/env bun\n/**\n * Convert Obsidian Markdown to X Article format\n *\n * Usage:\n * bun obsidian-to-x.ts <input.md> [output.md]\n * bun obsidian-to-x.ts Articles/my-article.md\n * bun obsidian-to-x.ts Articles/my-article.md Temp/converted.md\n */\n\nimport { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';\nimport { dirname, resolve, basename, join } from 'node:path';\nimport process from 'node:process';\n\ninterface ConversionOptions {\n inputFile: string;\n outputFile?: string;\n projectRoot?: string;\n}\n\n/**\n * Read Obsidian app.json configuration\n */\nfunction readObsidianConfig(projectRoot: string): { attachmentFolderPath?: string } {\n const configPath = join(projectRoot, '.obsidian', 'app.json');\n try {\n if (existsSync(configPath)) {\n const config = JSON.parse(readFileSync(configPath, 'utf-8'));\n return config;\n }\n } catch (error) {\n console.error('[config] Failed to read .obsidian/app.json:', error);\n }\n return {};\n}\n\n/**\n * Resolve image path with Obsidian attachment folder configuration\n */\nfunction resolveImagePath(imagePath: string, projectRoot: string, attachmentFolder?: string): string {\n // Extract filename from path\n const filename = basename(imagePath);\n\n // If already absolute path, check if it exists\n if (imagePath.startsWith('/')) {\n if (existsSync(imagePath)) {\n return imagePath;\n }\n // If absolute path doesn't exist, try to find the file by filename\n }\n\n // Try configured attachment folder first\n if (attachmentFolder) {\n const pathInAttachmentFolder = join(projectRoot, attachmentFolder, filename);\n if (existsSync(pathInAttachmentFolder)) {\n return pathInAttachmentFolder;\n }\n }\n\n // Try Attachments/ directory\n const pathInAttachments = join(projectRoot, 'Attachments', filename);\n if (existsSync(pathInAttachments)) {\n return pathInAttachments;\n }\n\n // Try with Attachments/ prefix if path already contains it\n if (imagePath.startsWith('Attachments/')) {\n const fullPath = join(projectRoot, imagePath);\n if (existsSync(fullPath)) {\n return fullPath;\n }\n }\n\n // Fallback: return original path or path in Attachments/\n return imagePath.startsWith('/') ? imagePath : join(projectRoot, 'Attachments', filename);\n}\n\nfunction convertObsidianToX(options: ConversionOptions): string {\n const { inputFile, projectRoot = process.cwd() } = options;\n\n // Read Obsidian configuration\n const config = readObsidianConfig(projectRoot);\n const attachmentFolder = config.attachmentFolderPath;\n\n if (attachmentFolder) {\n console.log(`[config] Using attachment folder: ${attachmentFolder}`);\n }\n\n // Read input file\n let content = readFileSync(inputFile, 'utf-8');\n\n // Step 1: Convert title field (标题: → title:)\n content = content.replace(/^标题:/gm, 'title:');\n\n // Step 1.5: Convert cover image field (封面: → cover_image:) BEFORE image syntax conversion\n // Support both formats: \"![[path]]\" and \"[#123] ![[path]]\"\n const coverMatch = content.match(/^封面:\\s*\"?(?:\\[#\\d+\\]\\s*)?!\\[\\[([^\\]]+)\\]\\]\"?/m);\n if (coverMatch) {\n const coverPath = coverMatch[1];\n const absoluteCoverPath = resolveImagePath(coverPath, projectRoot, attachmentFolder);\n content = content.replace(\n /^封面:.*$/m,\n `cover_image: ${absoluteCoverPath}`\n );\n }\n\n // Step 2: Convert Obsidian image syntax to standard Markdown\n // ![[Attachments/image.png]] → \n // ![[image.png]] → \n // ![[Attachments/image.png|alt text]] → \n\n // First, handle images WITH Attachments/ prefix\n content = content.replace(\n /!\\[\\[Attachments\\/([^\\]|]+)(?:\\|[^\\]]*)?\\]\\]/g,\n (match, imageName) => {\n const resolvedPath = resolveImagePath(imageName, projectRoot, attachmentFolder);\n return ``;\n }\n );\n\n // Then, handle images WITHOUT Attachments/ prefix (assume they're in attachment folder)\n content = content.replace(\n /!\\[\\[([^\\]|\\/]+\\.(?:png|jpg|jpeg|gif|webp|svg))(?:\\|[^\\]]*)?\\]\\]/gi,\n (match, imageName) => {\n const resolvedPath = resolveImagePath(imageName, projectRoot, attachmentFolder);\n return ``;\n }\n );\n\n // Step 2.5: Fix existing standard Markdown image paths\n //  →  if the path doesn't exist\n content = content.replace(\n /!\\[([^\\]]*)\\]\\(([^)]+)\\)/g,\n (match, alt, imagePath) => {\n // Skip URLs\n if (/^https?:\\/\\//i.test(imagePath)) {\n return match;\n }\n // Resolve the path\n const resolvedPath = resolveImagePath(imagePath, projectRoot, attachmentFolder);\n return ``;\n }\n );\n\n // Step 3: Remove Obsidian-specific placeholders\n content = content.replace(/^!\\[\\[wechatAccountCard\\]\\]\\s*$/gm, '');\n\n // Step 4: Remove [#number] prefix lines from blockquotes\n // Simply delete the entire line with [#number] prefix, keep the rest of the blockquote\n // Pattern: > [#6178] Title\\n\n content = content.replace(/^> \\[#\\d+\\] .+\\n/gm, '');\n\n // Step 4.5: Remove Obsidian callout syntax lines from blockquotes\n // Pattern: > [!type] Title\\n (e.g., [!question], [!note], [!tip], [!warning])\n // Simply delete the entire line with callout syntax, keep the rest of the blockquote\n content = content.replace(/^> \\[![a-z]+\\] .+\\n/gm, '');\n\n // Step 5: Extract and add English title if not present\n const titleMatch = content.match(/^标题:\\s*(.+)$/m);\n const hasTitleField = /^title:/m.test(content);\n if (titleMatch && !hasTitleField) {\n const title = titleMatch[1].trim();\n // Insert title field after the first line (after opening ---)\n content = content.replace(/^(---\\s*\\n)/, `$1title: ${title}\\n`);\n }\n\n return content;\n}\n\nfunction main() {\n const args = process.argv.slice(2);\n\n if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\n console.log(`\nUsage: bun obsidian-to-x.ts <input.md> [output.md]\n\nConvert Obsidian Markdown to X Article format.\n\nArguments:\n input.md Input Obsidian Markdown file\n output.md Output file (default: Temp/converted.md)\n\nExamples:\n bun obsidian-to-x.ts Articles/my-article.md\n bun obsidian-to-x.ts Articles/my-article.md Temp/output.md\n\nConversions:\n - 标题: → title:\n - ![[Attachments/img.png]] → \n - ![[wechatAccountCard]] → (removed)\n - > [#6178] Title → (removed)\n - > [!question] Title → (removed, Obsidian callout syntax)\n - 封面: → cover_image: (with absolute path)\n`);\n process.exit(0);\n }\n\n const inputFile = args[0];\n const projectRoot = process.cwd();\n\n // Generate output filename based on input filename\n // Output to skill's temp directory: .claude/skills/obsidian-to-x/temp/\n // Articles/my-article.md → .claude/skills/obsidian-to-x/temp/my-article-x.md\n const inputBasename = basename(inputFile, '.md');\n const skillTempDir = resolve(__dirname, '..', 'temp');\n const defaultOutput = resolve(skillTempDir, `${inputBasename}-x.md`);\n const outputFile = args[1] ? resolve(projectRoot, args[1]) : defaultOutput;\n\n try {\n // Ensure output directory exists\n mkdirSync(dirname(outputFile), { recursive: true });\n\n // Convert\n console.log(`Converting: ${inputFile}`);\n console.log(`Project root: ${projectRoot}`);\n\n const converted = convertObsidianToX({\n inputFile: resolve(projectRoot, inputFile),\n projectRoot,\n });\n\n // Write output\n writeFileSync(outputFile, converted, 'utf-8');\n console.log(`✅ Converted file saved to: ${outputFile}`);\n console.log(`\\nNext step: Publish to X Article`);\n console.log(` bun ${__dirname}/x-article.ts \"${outputFile}\"`);\n\n } catch (error) {\n console.error('❌ Error:', error instanceof Error ? error.message : error);\n process.exit(1);\n }\n}\n\nmain();\n"
},
{
"path": "skills/obsidian-to-x/scripts/obsidian-to-post.ts",
"content": "#!/usr/bin/env bun\n/**\n * Extract plain text and images from Obsidian Markdown for X posts\n *\n * Usage:\n * bun extract-post-content.ts <input.md>\n */\n\nimport { readFileSync, mkdirSync, existsSync } from 'node:fs';\nimport { resolve, join, basename, dirname } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport process from 'node:process';\nimport { spawn } from 'node:child_process';\nimport frontMatter from 'front-matter';\n\ninterface PostContent {\n text: string;\n images: string[];\n}\n\n/**\n * Check if a path is a URL\n */\nfunction isUrl(path: string): boolean {\n return /^https?:\\/\\//i.test(path);\n}\n\n/**\n * Read Obsidian app.json configuration\n */\nfunction readObsidianConfig(projectRoot: string): { attachmentFolderPath?: string } {\n const configPath = join(projectRoot, '.obsidian', 'app.json');\n try {\n if (existsSync(configPath)) {\n const config = JSON.parse(readFileSync(configPath, 'utf-8'));\n return config;\n }\n } catch (error) {\n console.error('[config] Failed to read .obsidian/app.json:', error);\n }\n return {};\n}\n\n/**\n * Resolve image path with Obsidian attachment folder configuration\n */\nfunction resolveImagePath(imagePath: string, projectRoot: string, attachmentFolder?: string): string {\n // Extract filename from path\n const filename = basename(imagePath);\n\n // If already absolute path, check if it exists\n if (imagePath.startsWith('/')) {\n if (existsSync(imagePath)) {\n return imagePath;\n }\n // If absolute path doesn't exist, try to find the file by filename\n }\n\n // Try configured attachment folder first\n if (attachmentFolder) {\n const pathInAttachmentFolder = join(projectRoot, attachmentFolder, filename);\n if (existsSync(pathInAttachmentFolder)) {\n return pathInAttachmentFolder;\n }\n }\n\n // Try Attachments/ directory\n const pathInAttachments = join(projectRoot, 'Attachments', filename);\n if (existsSync(pathInAttachments)) {\n return pathInAttachments;\n }\n\n // Try with Attachments/ prefix if path already contains it\n if (imagePath.startsWith('Attachments/')) {\n const fullPath = join(projectRoot, imagePath);\n if (existsSync(fullPath)) {\n return fullPath;\n }\n }\n\n // Fallback: return original path or path in Attachments/\n return imagePath.startsWith('/') ? imagePath : join(projectRoot, 'Attachments', filename);\n}\n\n/**\n * Download a single image from URL\n */\nasync function downloadImage(url: string, outputPath: string): Promise<void> {\n return new Promise((resolve, reject) => {\n const curl = spawn('curl', ['-s', '-L', '-o', outputPath, url]);\n curl.on('close', (code) => {\n if (code === 0) {\n resolve();\n } else {\n reject(new Error(`curl failed with code ${code}`));\n }\n });\n curl.on('error', reject);\n });\n}\n\n/**\n * Download multiple images in parallel\n */\nasync function downloadImagesParallel(urls: string[]): Promise<Map<string, string>> {\n const downloadDir = join(tmpdir(), 'x-post-images-' + Date.now());\n mkdirSync(downloadDir, { recursive: true });\n\n const urlToPath = new Map<string, string>();\n const downloadPromises = urls.map(async (url, index) => {\n // Extract extension from URL or default to .jpg\n const urlPath = new URL(url).pathname;\n const ext = urlPath.match(/\\.(png|jpg|jpeg|gif|webp)(\\?|$)/i)?.[1] || 'jpg';\n const filename = `image${index + 1}.${ext}`;\n const outputPath = join(downloadDir, filename);\n\n try {\n await downloadImage(url, outputPath);\n urlToPath.set(url, outputPath);\n console.error(`[download] ✓ ${basename(outputPath)}`);\n } catch (error) {\n console.error(`[download] ✗ Failed to download ${url}: ${error}`);\n }\n });\n\n await Promise.all(downloadPromises);\n return urlToPath;\n}\n\nasync function extractPostContent(markdownPath: string, projectRoot: string = process.cwd()): Promise<PostContent> {\n const content = readFileSync(markdownPath, 'utf-8');\n\n // Read Obsidian configuration\n const config = readObsidianConfig(projectRoot);\n const attachmentFolder = config.attachmentFolderPath;\n\n if (attachmentFolder) {\n console.error(`[config] Using attachment folder: ${attachmentFolder}`);\n }\n\n // Parse frontmatter\n let body: string;\n try {\n const parsed = frontMatter(content);\n body = parsed.body;\n } catch {\n body = content;\n }\n\n // Extract images and convert to absolute paths\n const imagePaths: string[] = [];\n const imageUrls: string[] = [];\n\n // Match standard Markdown: \n const standardImageRegex = /!\\[([^\\]]*)\\]\\(([^)]+)\\)/g;\n let match;\n\n while ((match = standardImageRegex.exec(body)) !== null) {\n const imagePath = match[2];\n if (isUrl(imagePath)) {\n imageUrls.push(imagePath);\n } else {\n // Use resolveImagePath to find the correct path\n const absolutePath = resolveImagePath(imagePath, projectRoot, attachmentFolder);\n imagePaths.push(absolutePath);\n }\n }\n\n // Match Obsidian syntax: ![[path]]\n const obsidianImageRegex = /!\\[\\[([^\\]]+)\\]\\]/g;\n while ((match = obsidianImageRegex.exec(body)) !== null) {\n const imagePath = match[1];\n if (isUrl(imagePath)) {\n imageUrls.push(imagePath);\n } else {\n // Use resolveImagePath to find the correct path\n const absolutePath = resolveImagePath(imagePath, projectRoot, attachmentFolder);\n imagePaths.push(absolutePath);\n }\n }\n\n // Download network images in parallel\n let urlToPath = new Map<string, string>();\n if (imageUrls.length > 0) {\n console.error(`[download] Downloading ${imageUrls.length} image(s) in parallel...`);\n urlToPath = await downloadImagesParallel(imageUrls);\n }\n\n // Combine local paths and downloaded paths (preserve order)\n const images: string[] = [];\n\n // Re-parse to maintain original order\n const allImageRegex = /!\\[([^\\]]*)\\]\\(([^)]+)\\)|!\\[\\[([^\\]]+)\\]\\]/g;\n while ((match = allImageRegex.exec(body)) !== null) {\n const imagePath = match[2] || match[3];\n if (isUrl(imagePath)) {\n const downloadedPath = urlToPath.get(imagePath);\n if (downloadedPath) {\n images.push(downloadedPath);\n }\n } else {\n // Use resolveImagePath to find the correct path\n const absolutePath = resolveImagePath(imagePath, projectRoot, attachmentFolder);\n images.push(absolutePath);\n }\n }\n\n // Remove all Markdown syntax to get plain text\n let text = body;\n\n // Remove images (both standard Markdown and Obsidian syntax)\n text = text.replace(/!\\[([^\\]]*)\\]\\(([^)]+)\\)/g, ''); // \n text = text.replace(/!\\[\\[([^\\]]+)\\]\\]/g, ''); // ![[path]]\n\n // Remove links but keep text: [text](url) -> text\n text = text.replace(/\\[([^\\]]+)\\]\\([^)]+\\)/g, '$1');\n\n // Remove bold/italic: **text** or *text* -> text\n text = text.replace(/\\*\\*([^*]+)\\*\\*/g, '$1');\n text = text.replace(/\\*([^*]+)\\*/g, '$1');\n\n // Remove headers: ## Header -> Header\n text = text.replace(/^#{1,6}\\s+(.+)$/gm, '$1');\n\n // Remove code blocks\n text = text.replace(/```[\\s\\S]*?```/g, '');\n\n // Remove inline code: `code` -> code\n text = text.replace(/`([^`]+)`/g, '$1');\n\n // Remove blockquotes: > text -> text\n text = text.replace(/^>\\s*/gm, '');\n\n // Remove horizontal rules\n text = text.replace(/^[-*_]{3,}$/gm, '');\n\n // Remove HTML tags\n text = text.replace(/<[^>]+>/g, '');\n\n // Unescape escaped periods in numbered lists at line start: 1\\. -> 1.\n // Only match at the beginning of lines (with optional whitespace before)\n text = text.replace(/^(\\s*)(\\d+)\\\\\\.\\s/gm, '$1$2. ');\n\n // Clean up multiple blank lines\n text = text.replace(/\\n{3,}/g, '\\n\\n');\n\n // Trim\n text = text.trim();\n\n return { text, images };\n}\n\nasync function main() {\n const args = process.argv.slice(2);\n\n if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\n console.log(`\nUsage: bun extract-post-content.ts <input.md>\n\nExtract plain text and images from Obsidian Markdown for X posts.\n\nArguments:\n input.md Input Markdown file\n\nOutput:\n JSON with { text, images }\n\nExample:\n bun extract-post-content.ts Articles/my-post.md\n`);\n process.exit(0);\n }\n\n const inputFile = args[0];\n const projectRoot = process.cwd();\n\n try {\n const result = await extractPostContent(resolve(projectRoot, inputFile), projectRoot);\n console.log(JSON.stringify(result, null, 2));\n } catch (error) {\n console.error('Error:', error instanceof Error ? error.message : error);\n process.exit(1);\n }\n}\n\nmain();\n"
},
{
"path": "skills/obsidian-to-x/scripts/package.json",
"content": "{\n \"name\": \"baoyu-post-to-x-scripts\",\n \"private\": true,\n \"type\": \"module\",\n \"dependencies\": {\n \"front-matter\": \"^4.0.2\",\n \"highlight.js\": \"^11.11.1\",\n \"marked\": \"^15.0.6\",\n \"remark-cjk-friendly\": \"^1.1.0\",\n \"remark-parse\": \"^11.0.0\",\n \"remark-stringify\": \"^11.0.0\",\n \"unified\": \"^11.0.5\"\n }\n}\n"
},
{
"path": "skills/obsidian-to-x/scripts/paste-from-clipboard.ts",
"content": "import { spawnSync } from 'node:child_process';\nimport process from 'node:process';\n\nfunction printUsage(exitCode = 0): never {\n console.log(`Send real paste keystroke (Cmd+V / Ctrl+V) to the frontmost application\n\nThis bypasses CDP's synthetic events which websites can detect and ignore.\n\nUsage:\n npx -y bun paste-from-clipboard.ts [options]\n\nOptions:\n --retries <n> Number of retry attempts (default: 3)\n --delay <ms> Delay between retries in ms (default: 500)\n --app <name> Target application to activate first (macOS only)\n --help Show this help\n\nExamples:\n # Simple paste\n npx -y bun paste-from-clipboard.ts\n\n # Paste to Chrome with retries\n npx -y bun paste-from-clipboard.ts --app \"Google Chrome\" --retries 5\n\n # Quick paste with shorter delay\n npx -y bun paste-from-clipboard.ts --delay 200\n`);\n process.exit(exitCode);\n}\n\nfunction sleepSync(ms: number): void {\n Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);\n}\n\nfunction activateApp(appName: string): boolean {\n if (process.platform !== 'darwin') return false;\n\n // Activate and wait for app to be frontmost\n const script = `\n tell application \"${appName}\"\n activate\n delay 0.5\n end tell\n\n -- Verify app is frontmost\n tell application \"System Events\"\n set frontApp to name of first application process whose frontmost is true\n if frontApp is not \"${appName}\" then\n tell application \"${appName}\" to activate\n delay 0.3\n end if\n end tell\n `;\n const result = spawnSync('osascript', ['-e', script], { stdio: 'pipe' });\n return result.status === 0;\n}\n\nfunction pasteMac(retries: number, delayMs: number, targetApp?: string): boolean {\n for (let i = 0; i < retries; i++) {\n // Build script that activates app (if specified) and sends keystroke in one atomic operation\n const script = targetApp\n ? `\n tell application \"${targetApp}\"\n activate\n end tell\n delay 0.3\n tell application \"System Events\"\n keystroke \"v\" using command down\n end tell\n `\n : `\n tell application \"System Events\"\n keystroke \"v\" using command down\n end tell\n `;\n\n const result = spawnSync('osascript', ['-e', script], { stdio: 'pipe' });\n if (result.status === 0) {\n return true;\n }\n\n const stderr = result.stderr?.toString().trim();\n if (stderr) {\n console.error(`[paste] osascript error: ${stderr}`);\n }\n\n if (i < retries - 1) {\n console.error(`[paste] Attempt ${i + 1}/${retries} failed, retrying in ${delayMs}ms...`);\n sleepSync(delayMs);\n }\n }\n return false;\n}\n\nfunction pasteLinux(retries: number, delayMs: number): boolean {\n // Try xdotool first (X11), then ydotool (Wayland)\n const tools = [\n { cmd: 'xdotool', args: ['key', 'ctrl+v'] },\n { cmd: 'ydotool', args: ['key', '29:1', '47:1', '47:0', '29:0'] }, // Ctrl down, V down, V up, Ctrl up\n ];\n\n for (const tool of tools) {\n const which = spawnSync('which', [tool.cmd], { stdio: 'pipe' });\n if (which.status !== 0) continue;\n\n for (let i = 0; i < retries; i++) {\n const result = spawnSync(tool.cmd, tool.args, { stdio: 'pipe' });\n if (result.status === 0) {\n return true;\n }\n if (i < retries - 1) {\n console.error(`[paste] Attempt ${i + 1}/${retries} failed, retrying in ${delayMs}ms...`);\n sleepSync(delayMs);\n }\n }\n return false;\n }\n\n console.error('[paste] No supported tool found. Install xdotool (X11) or ydotool (Wayland).');\n return false;\n}\n\nfunction pasteWindows(retries: number, delayMs: number): boolean {\n const ps = `\n Add-Type -AssemblyName System.Windows.Forms\n [System.Windows.Forms.SendKeys]::SendWait(\"^v\")\n `;\n\n for (let i = 0; i < retries; i++) {\n const result = spawnSync('powershell.exe', ['-NoProfile', '-Command', ps], { stdio: 'pipe' });\n if (result.status === 0) {\n return true;\n }\n if (i < retries - 1) {\n console.error(`[paste] Attempt ${i + 1}/${retries} failed, retrying in ${delayMs}ms...`);\n sleepSync(delayMs);\n }\n }\n return false;\n}\n\nfunction paste(retries: number, delayMs: number, targetApp?: string): boolean {\n switch (process.platform) {\n case 'darwin':\n return pasteMac(retries, delayMs, targetApp);\n case 'linux':\n return pasteLinux(retries, delayMs);\n case 'win32':\n return pasteWindows(retries, delayMs);\n default:\n console.error(`[paste] Unsupported platform: ${process.platform}`);\n return false;\n }\n}\n\nasync function main(): Promise<void> {\n const args = process.argv.slice(2);\n\n let retries = 3;\n let delayMs = 500;\n let targetApp: string | undefined;\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i] ?? '';\n if (arg === '--help' || arg === '-h') {\n printUsage(0);\n }\n if (arg === '--retries' && args[i + 1]) {\n retries = parseInt(args[++i]!, 10) || 3;\n } else if (arg === '--delay' && args[i + 1]) {\n delayMs = parseInt(args[++i]!, 10) || 500;\n } else if (arg === '--app' && args[i + 1]) {\n targetApp = args[++i];\n } else if (arg.startsWith('-')) {\n console.error(`Unknown option: ${arg}`);\n printUsage(1);\n }\n }\n\n if (targetApp) {\n console.log(`[paste] Target app: ${targetApp}`);\n }\n console.log(`[paste] Sending paste keystroke (retries=${retries}, delay=${delayMs}ms)...`);\n const success = paste(retries, delayMs, targetApp);\n\n if (success) {\n console.log('[paste] Paste keystroke sent successfully');\n } else {\n console.error('[paste] Failed to send paste keystroke');\n process.exit(1);\n }\n}\n\nawait main();\n"
},
{
"path": "skills/obsidian-to-x/scripts/publish-active.sh",
"content": "#!/bin/bash\n# Publish the currently active Obsidian file to X Articles\n# Usage: ./publish-active.sh\n\nset -e\n\n# Get script directory\nSCRIPT_DIR=\"$(cd \"$(dirname \"${BASH_SOURCE[0]}\")\" && pwd)\"\nSKILL_DIR=\"$(dirname \"$SCRIPT_DIR\")\"\n\n# Colors for output\nGREEN='\\033[0;32m'\nYELLOW='\\033[1;33m'\nRED='\\033[0;31m'\nNC='\\033[0m' # No Color\n\necho -e \"${GREEN}[1/4] Getting active file from Obsidian...${NC}\"\n\n# Get vault root (current directory should be the vault)\nVAULT_ROOT=\"$(pwd)\"\n\n# Method 1: Parse workspace.json (fast, 39x faster than CLI)\nif command -v jq &> /dev/null && [ -f \"$VAULT_ROOT/.obsidian/workspace.json\" ]; then\n ACTIVE_FILE=$(jq -r '.lastOpenFiles[0]' \"$VAULT_ROOT/.obsidian/workspace.json\" 2>/dev/null)\nfi\n\n# Fallback: use Obsidian CLI if workspace.json fails\nif [ -z \"$ACTIVE_FILE\" ] || [ ! -f \"$VAULT_ROOT/$ACTIVE_FILE\" ]; then\n echo -e \"${YELLOW}⚠️ workspace.json method failed, using Obsidian CLI fallback...${NC}\"\n\n if command -v obsidian &> /dev/null; then\n ACTIVE_FILE=$(obsidian recents 2>&1 | grep -v \"Loading\\|installer\" | head -1)\n fi\nfi\n\nif [ -z \"$ACTIVE_FILE\" ]; then\n echo -e \"${RED}Error: Could not determine active file${NC}\"\n echo \"Tried:\"\n echo \" 1. workspace.json (.obsidian/workspace.json)\"\n echo \" 2. Obsidian CLI (obsidian recents)\"\n echo \"\"\n echo \"Please:\"\n echo \" - Make sure you have opened a file in Obsidian recently\"\n echo \" - Install jq: brew install jq (macOS) or apt install jq (Linux)\"\n echo \" - Or enable Obsidian CLI: Settings → General → Command line interface\"\n exit 1\nfi\n\necho -e \"${GREEN}Active file: $ACTIVE_FILE${NC}\"\nFULL_PATH=\"$VAULT_ROOT/$ACTIVE_FILE\"\n\nif [ ! -f \"$FULL_PATH\" ]; then\n echo -e \"${RED}Error: File not found: $FULL_PATH${NC}\"\n exit 1\nfi\n\necho -e \"${GREEN}[2/4] Cleaning Chrome CDP processes...${NC}\"\npkill -f \"Chrome.*remote-debugging-port\" 2>/dev/null || true\npkill -f \"Chromium.*remote-debugging-port\" 2>/dev/null || true\nsleep 2\n\necho -e \"${GREEN}[3/4] Converting Obsidian syntax to X format...${NC}\"\nmkdir -p \"$VAULT_ROOT/Temp\"\nbun \"$SKILL_DIR/scripts/obsidian-to-article.ts\" \"$ACTIVE_FILE\" \"$VAULT_ROOT/Temp/converted.md\"\n\necho -e \"${GREEN}[4/4] Publishing to X Articles...${NC}\"\nbun \"$SKILL_DIR/scripts/x-article.ts\" \"$VAULT_ROOT/Temp/converted.md\"\n\necho -e \"${GREEN}✅ Done! Review and publish in the browser window.${NC}\"\n"
},
{
"path": "skills/obsidian-to-x/scripts/test-annotation-debug.ts",
"content": "import { Lexer } from 'marked';\n\nconst markdown = `> [#6171] Safe YOLO Mode\n> 您可以选择不监督 Claude，而是使用 \\`claude --dangerously-skip-permissions\\` 来绕过所有权限检查。`;\n\nconst tokens = Lexer.lex(markdown, { gfm: true, breaks: true });\n\nconsole.log('=== Blockquote Token ===');\nif (tokens[0]?.type === 'blockquote') {\n const bq = tokens[0] as any;\n console.log('Blockquote has', bq.tokens.length, 'tokens');\n \n if (bq.tokens[0]?.type === 'paragraph') {\n const para = bq.tokens[0];\n console.log('\\n=== Paragraph Tokens ===');\n console.log('Paragraph has', para.tokens.length, 'tokens');\n \n para.tokens.forEach((token: any, i: number) => {\n console.log(`\\nToken ${i}:`, {\n type: token.type,\n text: token.text || token.raw,\n });\n });\n \n if (para.tokens[0]?.type === 'text') {\n const text = para.tokens[0].text;\n console.log('\\n=== First Text Token ===');\n console.log('Text:', JSON.stringify(text));\n const match = text.match(/^\\[#\\d+\\]\\s+(.*)$/);\n console.log('Match result:', match);\n }\n }\n}\n"
},
{
"path": "skills/obsidian-to-x/scripts/test-code-insertion.ts",
"content": "import { spawn } from 'node:child_process';\nimport process from 'node:process';\nimport {\n CHROME_CANDIDATES_BASIC,\n CdpConnection,\n findChromeExecutable,\n getDefaultProfileDir,\n getFreePort,\n sleep,\n waitForChromeDebugPort,\n} from './x-utils.js';\n\nconst X_ARTICLES_URL = 'https://x.com/compose/articles';\n\nasync function testCodeBlockInsertion(): Promise<void> {\n const chromePath = findChromeExecutable(CHROME_CANDIDATES_BASIC);\n if (!chromePath) throw new Error('Chrome not found');\n\n const profileDir = getDefaultProfileDir();\n const port = await getFreePort();\n\n console.log('[test] Launching Chrome...');\n const chromeArgs = [\n `--remote-debugging-port=${port}`,\n `--user-data-dir=${profileDir}`,\n '--no-first-run',\n '--no-default-browser-check',\n '--disable-blink-features=AutomationControlled',\n '--start-maximized',\n X_ARTICLES_URL,\n ];\n\n if (process.platform === 'darwin') {\n const appPath = chromePath.replace(/\\/Contents\\/MacOS\\/Google Chrome$/, '');\n spawn('open', ['-na', appPath, '--args', ...chromeArgs], { stdio: 'ignore' });\n } else {\n spawn(chromePath, chromeArgs, { stdio: 'ignore' });\n }\n\n let cdp: CdpConnection | null = null;\n\n try {\n const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });\n cdp = await CdpConnection.connect(wsUrl, 30_000, { defaultTimeoutMs: 60_000 });\n\n const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');\n let pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.startsWith(X_ARTICLES_URL));\n\n if (!pageTarget) {\n const { targetId } = await cdp.send<{ targetId: string }>('Target.createTarget', { url: X_ARTICLES_URL });\n pageTarget = { targetId, url: X_ARTICLES_URL, type: 'page' };\n }\n\n const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', { targetId: pageTarget.targetId, flatten: true });\n\n await cdp.send('Page.enable', {}, { sessionId });\n await cdp.send('Runtime.enable', {}, { sessionId });\n await cdp.send('DOM.enable', {}, { sessionId });\n\n console.log('[test] Waiting for page to load...');\n await sleep(5000);\n\n // 检查页面内容\n console.log('[test] Checking page content...');\n const pageCheck = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `(() => {\n return JSON.stringify({\n title: document.title,\n url: window.location.href,\n hasEditor: !!document.querySelector('.DraftEditor-editorContainer'),\n hasWriteButton: !!document.querySelector('[data-testid=\"empty_state_button_text\"]'),\n bodyText: document.body.innerText.substring(0, 500)\n });\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n console.log('[test] Page info:', pageCheck.result.value);\n\n // 检查是否需要点击 Write 按钮\n console.log('[test] Checking for Write button...');\n const writeButtonCheck = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[data-testid=\"empty_state_button_text\"]')`,\n returnByValue: true,\n }, { sessionId });\n\n if (writeButtonCheck.result.value) {\n console.log('[test] Clicking Write button...');\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"empty_state_button_text\"]')?.click()`,\n }, { sessionId });\n await sleep(2000);\n }\n\n // 等待编辑器出现\n console.log('[test] Waiting for editor...');\n const waitForEditor = async (): Promise<boolean> => {\n for (let i = 0; i < 30; i++) {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]')`,\n returnByValue: true,\n }, { sessionId });\n if (result.result.value) return true;\n await sleep(1000);\n }\n return false;\n };\n\n const editorFound = await waitForEditor();\n if (!editorFound) {\n console.log('[test] Editor not found after 30 seconds!');\n throw new Error('Editor not found');\n }\n\n console.log('[test] Editor found!');\n\n // 1. 在编辑器中输入一些文字\n console.log('[test] Inserting text into editor...');\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (editor) {\n editor.focus();\n document.execCommand('insertText', false, '测试文字\\\\n\\\\n');\n return true;\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(1000);\n\n // 2. 点击 Insert 菜单\n console.log('[test] Opening Insert menu...');\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[aria-label=\"Add Media\"]')?.click()`,\n }, { sessionId });\n await sleep(500);\n\n // 3. 点击 Code 选项\n console.log('[test] Clicking Code option...');\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const items = document.querySelectorAll('[role=\"menuitem\"]');\n for (const item of items) {\n if (item.textContent.toLowerCase().includes('code')) {\n item.click();\n return true;\n }\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(1500);\n\n // 4. 填入语言\n console.log('[test] Filling language...');\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const langInput = document.querySelector('input[data-testid=\"programming-language-input\"]');\n if (langInput) {\n langInput.value = 'python';\n langInput.dispatchEvent(new Event('input', { bubbles: true }));\n return true;\n }\n return false;\n })()`,\n }, { sessionId });\n\n // 5. 填入代码\n console.log('[test] Filling code...');\n const testCode = `def hello_world():\n print(\"Hello, World!\")\n return True\n\nhello_world()`;\n\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const codeTextarea = document.querySelector('textarea[name=\"code-input\"]');\n if (codeTextarea) {\n codeTextarea.value = ${JSON.stringify(testCode)};\n codeTextarea.dispatchEvent(new Event('input', { bubbles: true }));\n return true;\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(500);\n\n // 6. 点击 Insert 按钮\n console.log('[test] Clicking Insert button...');\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const buttons = Array.from(document.querySelectorAll('button'));\n const insertBtn = buttons.find(btn => btn.textContent.trim() === 'Insert' && !btn.disabled);\n if (insertBtn) {\n insertBtn.click();\n return true;\n }\n return false;\n })()`,\n }, { sessionId });\n\n // 7. 等待并检查结果\n console.log('[test] Waiting for insertion...');\n await sleep(2000);\n\n // 7.5 检查对话框是否关闭\n const dialogCheck = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[data-testid=\"sheetDialog\"]')`,\n returnByValue: true,\n }, { sessionId });\n console.log('[test] Dialog still open:', dialogCheck.result.value);\n\n if (dialogCheck.result.value) {\n console.log('[test] Dialog still open, waiting more...');\n await sleep(3000);\n }\n\n // 7.6 尝试点击编辑器来\"确认\"插入\n console.log('[test] Clicking editor to confirm...');\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (editor) {\n editor.click();\n editor.focus();\n return true;\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(1000);\n\n // 8. 检查编辑器内容\n console.log('[test] Checking editor content...');\n const editorCheck = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]');\n return editor ? editor.innerText : '';\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n console.log('[test] Editor text:', editorCheck.result.value);\n console.log('[test] Editor text length:', editorCheck.result.value.length);\n\n // 9. 检查 blocks\n const blocksCheck = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelectorAll('[data-block=\"true\"]').length`,\n returnByValue: true,\n }, { sessionId });\n\n console.log('[test] Total blocks:', blocksCheck.result.value);\n\n // 10. 获取所有 blocks 的详细信息\n const blocksInfo = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `(() => {\n const blocks = document.querySelectorAll('[data-block=\"true\"]');\n const info = [];\n blocks.forEach((block, i) => {\n info.push({\n index: i,\n tag: block.tagName,\n contenteditable: block.getAttribute('contenteditable'),\n hasCode: !!block.querySelector('code'),\n hasPre: !!block.querySelector('pre'),\n text: block.textContent.substring(0, 100),\n html: block.innerHTML.substring(0, 300)\n });\n });\n return JSON.stringify(info, null, 2);\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n console.log('[test] Blocks info:', blocksInfo.result.value);\n\n // 11. 获取编辑器的完整 HTML\n const editorHtml = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]');\n return editor ? editor.innerHTML.substring(0, 1000) : '';\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n console.log('[test] Editor HTML:', editorHtml.result.value);\n\n console.log('[test] Test complete. Browser will remain open for 60 seconds for inspection.');\n await sleep(60_000);\n\n } finally {\n if (cdp) {\n cdp.close();\n }\n }\n}\n\nawait testCodeBlockInsertion().catch((err) => {\n console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n});\n"
},
{
"path": "skills/obsidian-to-x/scripts/x-article.ts",
"content": "import { spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport process from 'node:process';\n\nimport { parseMarkdown } from './md-to-html.js';\nimport {\n CHROME_CANDIDATES_BASIC,\n CdpConnection,\n copyHtmlToClipboard,\n copyImageToClipboard,\n findChromeExecutable,\n getDefaultProfileDir,\n getFreePort,\n pasteFromClipboard,\n sleep,\n waitForChromeDebugPort,\n} from './x-utils.js';\nimport { insertCodeBlocks } from './insert-code-blocks.js';\n\nconst X_ARTICLES_URL = 'https://x.com/compose/articles';\n\nconst I18N_SELECTORS = {\n titleInput: [\n 'textarea[placeholder=\"Add a title\"]',\n 'textarea[placeholder=\"添加标题\"]',\n 'textarea[placeholder=\"タイトルを追加\"]',\n 'textarea[placeholder=\"제목 추가\"]',\n 'textarea[name=\"Article Title\"]',\n ],\n addPhotosButton: [\n '[aria-label=\"Add photos or video\"]',\n '[aria-label=\"添加照片或视频\"]',\n '[aria-label=\"写真や動画を追加\"]',\n '[aria-label=\"사진 또는 동영상 추가\"]',\n ],\n previewButton: [\n 'a[href*=\"/preview\"]',\n '[data-testid=\"previewButton\"]',\n 'button[aria-label*=\"preview\" i]',\n 'button[aria-label*=\"预览\" i]',\n 'button[aria-label*=\"プレビュー\" i]',\n 'button[aria-label*=\"미리보기\" i]',\n ],\n publishButton: [\n '[data-testid=\"publishButton\"]',\n 'button[aria-label*=\"publish\" i]',\n 'button[aria-label*=\"发布\" i]',\n 'button[aria-label*=\"公開\" i]',\n 'button[aria-label*=\"게시\" i]',\n ],\n};\n\ninterface ArticleOptions {\n markdownPath: string;\n coverImage?: string;\n title?: string;\n submit?: boolean;\n profileDir?: string;\n chromePath?: string;\n}\n\nasync function findExistingDebugPort(profileDir: string): Promise<number | null> {\n const portFile = path.join(profileDir, 'DevToolsActivePort');\n if (!fs.existsSync(portFile)) return null;\n\n try {\n const content = fs.readFileSync(portFile, 'utf-8').trim();\n if (!content) return null;\n const [portLine] = content.split(/\\r?\\n/);\n const port = Number(portLine);\n if (!Number.isFinite(port) || port <= 0) return null;\n\n // Verify the port is actually active.\n await waitForChromeDebugPort(port, 1500, { includeLastError: true });\n return port;\n } catch {\n return null;\n }\n}\n\nexport async function publishArticle(options: ArticleOptions): Promise<void> {\n const { markdownPath, submit = false, profileDir = getDefaultProfileDir() } = options;\n\n console.log('[x-article] Parsing markdown...');\n const parsed = await parseMarkdown(markdownPath, {\n title: options.title,\n coverImage: options.coverImage,\n });\n\n console.log(`[x-article] Title: ${parsed.title}`);\n console.log(`[x-article] Cover: ${parsed.coverImage ?? 'none'}`);\n console.log(`[x-article] Content images: ${parsed.contentImages.length}`);\n\n // Save HTML to temp file\n const htmlPath = path.join(os.tmpdir(), 'x-article-content.html');\n await writeFile(htmlPath, parsed.html, 'utf-8');\n console.log(`[x-article] HTML saved to: ${htmlPath}`);\n\n const chromePath = options.chromePath ?? findChromeExecutable(CHROME_CANDIDATES_BASIC);\n if (!chromePath) throw new Error('Chrome not found');\n\n await mkdir(profileDir, { recursive: true });\n const existingPort = await findExistingDebugPort(profileDir);\n const port = existingPort ?? await getFreePort();\n\n if (existingPort) {\n console.log(`[x-article] Reusing existing Chrome instance on port ${port}`);\n } else {\n console.log(`[x-article] Launching Chrome...`);\n const chromeArgs = [\n `--remote-debugging-port=${port}`,\n `--user-data-dir=${profileDir}`,\n '--no-first-run',\n '--no-default-browser-check',\n '--disable-blink-features=AutomationControlled',\n '--start-maximized',\n X_ARTICLES_URL,\n ];\n if (process.platform === 'darwin') {\n const appPath = chromePath.replace(/\\/Contents\\/MacOS\\/Google Chrome$/, '');\n spawn('open', ['-na', appPath, '--args', ...chromeArgs], { stdio: 'ignore' });\n } else {\n spawn(chromePath, chromeArgs, { stdio: 'ignore' });\n }\n }\n\n let cdp: CdpConnection | null = null;\n\n try {\n const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });\n cdp = await CdpConnection.connect(wsUrl, 30_000, { defaultTimeoutMs: 60_000 });\n\n // Get page target\n const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');\n let pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.startsWith(X_ARTICLES_URL));\n\n if (!pageTarget) {\n const { targetId } = await cdp.send<{ targetId: string }>('Target.createTarget', { url: X_ARTICLES_URL });\n pageTarget = { targetId, url: X_ARTICLES_URL, type: 'page' };\n }\n\n const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', { targetId: pageTarget.targetId, flatten: true });\n\n await cdp.send('Page.enable', {}, { sessionId });\n await cdp.send('Runtime.enable', {}, { sessionId });\n await cdp.send('DOM.enable', {}, { sessionId });\n\n console.log('[x-article] Waiting for articles page...');\n await sleep(1000);\n\n // Wait for and click \"create\" button\n const waitForElement = async (selector: string, timeoutMs = 60_000): Promise<boolean> => {\n const start = Date.now();\n while (Date.now() - start < timeoutMs) {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('${selector}')`,\n returnByValue: true,\n }, { sessionId });\n if (result.result.value) return true;\n await sleep(500);\n }\n return false;\n };\n\n const clickElement = async (selector: string): Promise<boolean> => {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => { const el = document.querySelector('${selector}'); if (el) { el.click(); return true; } return false; })()`,\n returnByValue: true,\n }, { sessionId });\n return result.result.value;\n };\n\n const typeText = async (selector: string, text: string): Promise<void> => {\n await cdp!.send('Runtime.evaluate', {\n expression: `(() => {\n const el = document.querySelector('${selector}');\n if (el) {\n el.focus();\n document.execCommand('insertText', false, ${JSON.stringify(text)});\n }\n })()`,\n }, { sessionId });\n };\n\n const pressKey = async (key: string, modifiers = 0): Promise<void> => {\n await cdp!.send('Input.dispatchKeyEvent', {\n type: 'keyDown',\n key,\n code: `Key${key.toUpperCase()}`,\n modifiers,\n windowsVirtualKeyCode: key.toUpperCase().charCodeAt(0),\n }, { sessionId });\n await cdp!.send('Input.dispatchKeyEvent', {\n type: 'keyUp',\n key,\n code: `Key${key.toUpperCase()}`,\n modifiers,\n windowsVirtualKeyCode: key.toUpperCase().charCodeAt(0),\n }, { sessionId });\n };\n\n // Check if we're on the articles list page (has Write button)\n console.log('[x-article] Looking for Write button...');\n const writeButtonFound = await waitForElement('[data-testid=\"empty_state_button_text\"]', 10_000);\n\n if (writeButtonFound) {\n console.log('[x-article] Clicking Write button...');\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"empty_state_button_text\"]')?.click()`,\n }, { sessionId });\n await sleep(2000);\n }\n\n // Wait for editor (title textarea)\n const titleSelectors = I18N_SELECTORS.titleInput.join(', ');\n console.log('[x-article] Waiting for editor...');\n const editorFound = await waitForElement(titleSelectors, 30_000);\n if (!editorFound) {\n console.log('[x-article] Editor not found. Please ensure you have X Premium and are logged in.');\n await sleep(60_000);\n throw new Error('Editor not found');\n }\n\n // Upload cover image\n if (parsed.coverImage) {\n console.log('[x-article] Uploading cover image...');\n\n // Click \"Add photos or video\" button\n const addPhotosSelectors = JSON.stringify(I18N_SELECTORS.addPhotosButton);\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const selectors = ${addPhotosSelectors};\n for (const sel of selectors) {\n const el = document.querySelector(sel);\n if (el) { el.click(); return true; }\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(500);\n\n // Use file input directly\n const { root } = await cdp.send<{ root: { nodeId: number } }>('DOM.getDocument', {}, { sessionId });\n const { nodeId } = await cdp.send<{ nodeId: number }>('DOM.querySelector', {\n nodeId: root.nodeId,\n selector: '[data-testid=\"fileInput\"], input[type=\"file\"][accept*=\"image\"]',\n }, { sessionId });\n\n if (nodeId) {\n await cdp.send('DOM.setFileInputFiles', {\n nodeId,\n files: [parsed.coverImage],\n }, { sessionId });\n console.log('[x-article] Cover image file set');\n\n // Wait for Apply button to appear and click it\n console.log('[x-article] Waiting for Apply button...');\n const applyFound = await waitForElement('[data-testid=\"applyButton\"]', 15_000);\n if (applyFound) {\n // Check if modal is present\n const isModalOpen = async (): Promise<boolean> => {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[role=\"dialog\"][aria-modal=\"true\"]')`,\n returnByValue: true,\n }, { sessionId });\n return result.result.value;\n };\n\n // Click Apply button with retry logic\n const maxRetries = 3;\n for (let attempt = 1; attempt <= maxRetries; attempt++) {\n console.log(`[x-article] Clicking Apply button (attempt ${attempt}/${maxRetries})...`);\n\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"applyButton\"]')?.click()`,\n }, { sessionId });\n\n // Wait for modal to close (up to 5 seconds per attempt)\n const closeTimeout = 5000;\n const checkInterval = 300;\n const startTime = Date.now();\n let modalClosed = false;\n\n while (Date.now() - startTime < closeTimeout) {\n await sleep(checkInterval);\n const stillOpen = await isModalOpen();\n if (!stillOpen) {\n modalClosed = true;\n break;\n }\n }\n\n if (modalClosed) {\n console.log('[x-article] Cover image applied, modal closed');\n await sleep(500);\n break;\n }\n\n if (attempt < maxRetries) {\n console.log('[x-article] Modal still open, retrying...');\n } else {\n console.log('[x-article] Modal did not close after all attempts, continuing anyway...');\n }\n }\n } else {\n console.log('[x-article] Apply button not found, continuing...');\n }\n }\n }\n\n // Fill title using keyboard input\n if (parsed.title) {\n console.log('[x-article] Filling title...');\n\n // Focus title input\n const titleInputSelectors = JSON.stringify(I18N_SELECTORS.titleInput);\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const selectors = ${titleInputSelectors};\n for (const sel of selectors) {\n const el = document.querySelector(sel);\n if (el) { el.focus(); return true; }\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(200);\n\n // Type title character by character using insertText\n await cdp.send('Input.insertText', { text: parsed.title }, { sessionId });\n await sleep(300);\n\n // Tab out to trigger save\n await cdp.send('Input.dispatchKeyEvent', { type: 'keyDown', key: 'Tab', code: 'Tab', windowsVirtualKeyCode: 9 }, { sessionId });\n await cdp.send('Input.dispatchKeyEvent', { type: 'keyUp', key: 'Tab', code: 'Tab', windowsVirtualKeyCode: 9 }, { sessionId });\n await sleep(500);\n }\n\n // Insert HTML content\n console.log('[x-article] Inserting content...');\n\n // Read HTML content\n const htmlContent = fs.readFileSync(htmlPath, 'utf-8');\n\n // Focus on DraftEditor body\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (editor) {\n editor.focus();\n editor.click();\n return true;\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(300);\n\n // Method 1: Simulate paste event with HTML data\n console.log('[x-article] Attempting to insert HTML via paste event...');\n const pasteResult = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (!editor) return false;\n\n const html = ${JSON.stringify(htmlContent)};\n\n // Create a paste event with HTML data\n const dt = new DataTransfer();\n dt.setData('text/html', html);\n dt.setData('text/plain', html.replace(/<[^>]*>/g, ''));\n\n const pasteEvent = new ClipboardEvent('paste', {\n bubbles: true,\n cancelable: true,\n clipboardData: dt\n });\n\n editor.dispatchEvent(pasteEvent);\n return true;\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n await sleep(1000);\n\n // Check if content was inserted\n const contentCheck = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]')?.innerText?.length || 0`,\n returnByValue: true,\n }, { sessionId });\n\n if (contentCheck.result.value > 50) {\n console.log(`[x-article] Content inserted successfully (${contentCheck.result.value} chars)`);\n } else {\n console.log('[x-article] Paste event may not have worked, trying insertHTML...');\n\n // Method 2: Use execCommand insertHTML\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (!editor) return false;\n editor.focus();\n document.execCommand('insertHTML', false, ${JSON.stringify(htmlContent)});\n return true;\n })()`,\n }, { sessionId });\n\n await sleep(1000);\n\n // Check again\n const check2 = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]')?.innerText?.length || 0`,\n returnByValue: true,\n }, { sessionId });\n\n if (check2.result.value > 50) {\n console.log(`[x-article] Content inserted via execCommand (${check2.result.value} chars)`);\n } else {\n console.log('[x-article] Auto-insert failed. HTML copied to clipboard - please paste manually (Cmd+V)');\n copyHtmlToClipboard(htmlPath);\n // Wait for manual paste\n console.log('[x-article] Waiting 30s for manual paste...');\n await sleep(30_000);\n }\n }\n\n // Insert content images (reverse order to maintain positions)\n if (parsed.contentImages.length > 0) {\n console.log('[x-article] Inserting content images...');\n\n // First, check what placeholders exist in the editor\n const editorContent = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]')?.innerText || ''`,\n returnByValue: true,\n }, { sessionId });\n\n console.log('[x-article] Checking for placeholders in content...');\n for (const img of parsed.contentImages) {\n // Use regex for exact match (not followed by digit, e.g., XIMGPH_1 should not match XIMGPH_10)\n const regex = new RegExp(img.placeholder + '(?!\\\\d)');\n if (regex.test(editorContent.result.value)) {\n console.log(`[x-article] Found: ${img.placeholder}`);\n } else {\n console.log(`[x-article] NOT found: ${img.placeholder}`);\n }\n }\n\n // Process images in XIMGPH order (1, 2, 3, ...) regardless of blockIndex\n const getPlaceholderIndex = (placeholder: string): number => {\n const match = placeholder.match(/XIMGPH_(\\d+)/);\n return match ? Number(match[1]) : Number.POSITIVE_INFINITY;\n };\n const sortedImages = [...parsed.contentImages].sort(\n (a, b) => getPlaceholderIndex(a.placeholder) - getPlaceholderIndex(b.placeholder),\n );\n\n for (let i = 0; i < sortedImages.length; i++) {\n const img = sortedImages[i]!;\n console.log(`[x-article] [${i + 1}/${sortedImages.length}] Inserting image at placeholder: ${img.placeholder}`);\n\n // Helper to select placeholder with retry\n const selectPlaceholder = async (maxRetries = 3): Promise<boolean> => {\n for (let attempt = 1; attempt <= maxRetries; attempt++) {\n // Find, scroll to, and select the placeholder text in DraftEditor\n await cdp!.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]');\n if (!editor) return false;\n\n const placeholder = ${JSON.stringify(img.placeholder)};\n\n // Search through all text nodes in the editor\n const walker = document.createTreeWalker(editor, NodeFilter.SHOW_TEXT, null, false);\n let node;\n\n while ((node = walker.nextNode())) {\n const text = node.textContent || '';\n let searchStart = 0;\n let idx;\n // Search for exact match (not prefix of longer placeholder like XIMGPH_1 in XIMGPH_10)\n while ((idx = text.indexOf(placeholder, searchStart)) !== -1) {\n const afterIdx = idx + placeholder.length;\n const charAfter = text[afterIdx];\n // Exact match if next char is not a digit (XIMGPH_1 should not match XIMGPH_10)\n if (charAfter === undefined || !/\\\\d/.test(charAfter)) {\n // Found exact placeholder - scroll to it first\n const parentElement = node.parentElement;\n if (parentElement) {\n parentElement.scrollIntoView({ behavior: 'smooth', block: 'center' });\n }\n\n // Select it\n const range = document.createRange();\n range.setStart(node, idx);\n range.setEnd(node, idx + placeholder.length);\n const sel = window.getSelection();\n sel.removeAllRanges();\n sel.addRange(range);\n return true;\n }\n searchStart = afterIdx;\n }\n }\n return false;\n })()`,\n }, { sessionId });\n\n // Wait for scroll and selection to settle\n await sleep(800);\n\n // Verify selection matches the placeholder\n const selectionCheck = await cdp!.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `window.getSelection()?.toString() || ''`,\n returnByValue: true,\n }, { sessionId });\n\n const selectedText = selectionCheck.result.value.trim();\n if (selectedText === img.placeholder) {\n console.log(`[x-article] Selection verified: \"${selectedText}\"`);\n return true;\n }\n\n if (attempt < maxRetries) {\n console.log(`[x-article] Selection attempt ${attempt} got \"${selectedText}\", retrying...`);\n await sleep(500);\n } else {\n console.warn(`[x-article] Selection failed after ${maxRetries} attempts, got: \"${selectedText}\"`);\n }\n }\n return false;\n };\n\n // Try to select the placeholder\n const selected = await selectPlaceholder(3);\n if (!selected) {\n console.warn(`[x-article] Skipping image - could not select placeholder: ${img.placeholder}`);\n continue;\n }\n\n console.log(`[x-article] Copying image: ${path.basename(img.localPath)}`);\n\n // Copy image to clipboard\n if (!copyImageToClipboard(img.localPath)) {\n console.warn(`[x-article] Failed to copy image to clipboard`);\n continue;\n }\n\n // Wait for clipboard to be fully ready\n await sleep(1000);\n\n // Delete placeholder using execCommand (more reliable than keyboard events for DraftJS)\n console.log(`[x-article] Deleting placeholder...`);\n const deleteResult = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => {\n const sel = window.getSelection();\n if (!sel || sel.isCollapsed) return false;\n // Try execCommand delete first\n if (document.execCommand('delete', false)) return true;\n // Fallback: replace selection with empty using insertText\n document.execCommand('insertText', false, '');\n return true;\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n await sleep(500);\n\n // Check that placeholder is no longer in editor (exact match, not substring)\n const afterDelete = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]');\n if (!editor) return true;\n const text = editor.innerText;\n const placeholder = ${JSON.stringify(img.placeholder)};\n // Use regex to find exact match (not followed by digit)\n const regex = new RegExp(placeholder + '(?!\\\\\\\\d)');\n return !regex.test(text);\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n if (!afterDelete.result.value) {\n console.warn(`[x-article] Placeholder may not have been deleted, trying dispatchEvent...`);\n // Try selecting and deleting with InputEvent\n await selectPlaceholder(1);\n await sleep(300);\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (!editor) return;\n editor.focus();\n // Dispatch beforeinput and input events for deletion\n const beforeEvent = new InputEvent('beforeinput', { inputType: 'deleteContentBackward', bubbles: true, cancelable: true });\n editor.dispatchEvent(beforeEvent);\n const inputEvent = new InputEvent('input', { inputType: 'deleteContentBackward', bubbles: true });\n editor.dispatchEvent(inputEvent);\n })()`,\n }, { sessionId });\n await sleep(500);\n }\n\n // Count existing image blocks before paste\n const imgCountBefore = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelectorAll('section[data-block=\"true\"][contenteditable=\"false\"] img[src^=\"blob:\"]').length`,\n returnByValue: true,\n }, { sessionId });\n\n // Focus editor to ensure cursor is in position\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (editor) editor.focus();\n })()`,\n }, { sessionId });\n await sleep(300);\n\n // Paste image using paste script (activates Chrome, sends real keystroke)\n console.log(`[x-article] Pasting image...`);\n if (pasteFromClipboard('Google Chrome', 5, 1000)) {\n console.log(`[x-article] Image pasted: ${path.basename(img.localPath)}`);\n } else {\n console.warn(`[x-article] Failed to paste image after retries`);\n }\n\n // Verify image appeared in editor\n console.log(`[x-article] Verifying image upload...`);\n const expectedImgCount = imgCountBefore.result.value + 1;\n let imgUploadOk = false;\n const imgWaitStart = Date.now();\n while (Date.now() - imgWaitStart < 15_000) {\n const r = await cdp!.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelectorAll('section[data-block=\"true\"][contenteditable=\"false\"] img[src^=\"blob:\"]').length`,\n returnByValue: true,\n }, { sessionId });\n if (r.result.value >= expectedImgCount) {\n imgUploadOk = true;\n break;\n }\n await sleep(1000);\n }\n\n if (imgUploadOk) {\n console.log(`[x-article] Image upload verified (${expectedImgCount} image block(s))`);\n // Wait for DraftEditor DOM to stabilize after image insertion\n await sleep(3000);\n } else {\n console.warn(`[x-article] Image upload not detected after 15s`);\n if (i === 0) {\n console.error('[x-article] First image paste failed. Run check-paste-permissions.ts to diagnose.');\n }\n }\n }\n\n console.log('[x-article] All images processed.');\n\n // Final verification: check placeholder residue and image count\n console.log('[x-article] Running post-composition verification...');\n const finalEditorContent = await cdp.send<{ result: { value: string } }>('Runtime.evaluate', {\n expression: `document.querySelector('.DraftEditor-editorContainer [data-contents=\"true\"]')?.innerText || ''`,\n returnByValue: true,\n }, { sessionId });\n\n const remainingPlaceholders: string[] = [];\n for (const img of parsed.contentImages) {\n const regex = new RegExp(img.placeholder + '(?!\\\\d)');\n if (regex.test(finalEditorContent.result.value)) {\n remainingPlaceholders.push(img.placeholder);\n }\n }\n\n const finalImgCount = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelectorAll('section[data-block=\"true\"][contenteditable=\"false\"] img[src^=\"blob:\"]').length`,\n returnByValue: true,\n }, { sessionId });\n\n const expectedCount = parsed.contentImages.length;\n const actualCount = finalImgCount.result.value;\n\n if (remainingPlaceholders.length > 0 || actualCount < expectedCount) {\n console.warn('[x-article] ⚠ POST-COMPOSITION CHECK FAILED:');\n if (remainingPlaceholders.length > 0) {\n console.warn(`[x-article] Remaining placeholders: ${remainingPlaceholders.join(', ')}`);\n }\n if (actualCount < expectedCount) {\n console.warn(`[x-article] Image count: expected ${expectedCount}, found ${actualCount}`);\n }\n console.warn('[x-article] Please check the article before publishing.');\n } else {\n console.log(`[x-article] ✓ Verification passed: ${actualCount} image(s), no remaining placeholders.`);\n }\n }\n\n // Insert code blocks\n if (parsed.codeBlocks.length > 0) {\n console.log(`[x-article] Inserting ${parsed.codeBlocks.length} code blocks...`);\n await insertCodeBlocks(cdp, sessionId, parsed.codeBlocks);\n console.log('[x-article] Code blocks insertion completed.');\n }\n\n // Before preview: blur editor to trigger save\n console.log('[x-article] Triggering content save...');\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n // Blur editor to trigger any pending saves\n const editor = document.querySelector('.DraftEditor-editorContainer [contenteditable=\"true\"]');\n if (editor) {\n editor.blur();\n }\n // Also click elsewhere to ensure focus is lost\n document.body.click();\n })()`,\n }, { sessionId });\n await sleep(1500);\n\n // Click Preview button\n console.log('[x-article] Opening preview...');\n const previewSelectors = JSON.stringify(I18N_SELECTORS.previewButton);\n const previewClicked = await cdp.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `(() => {\n const selectors = ${previewSelectors};\n for (const sel of selectors) {\n const el = document.querySelector(sel);\n if (el) { el.click(); return true; }\n }\n return false;\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n if (previewClicked.result.value) {\n console.log('[x-article] Preview opened');\n await sleep(3000);\n } else {\n console.log('[x-article] Preview button not found');\n }\n\n // Check for publish button\n if (submit) {\n console.log('[x-article] Publishing...');\n const publishSelectors = JSON.stringify(I18N_SELECTORS.publishButton);\n await cdp.send('Runtime.evaluate', {\n expression: `(() => {\n const selectors = ${publishSelectors};\n for (const sel of selectors) {\n const el = document.querySelector(sel);\n if (el && !el.disabled) { el.click(); return true; }\n }\n return false;\n })()`,\n }, { sessionId });\n await sleep(3000);\n console.log('[x-article] Article published!');\n } else {\n console.log('[x-article] Article composed (draft mode).');\n console.log('[x-article] Browser remains open for manual review.');\n }\n\n } finally {\n // Disconnect CDP but keep browser open\n if (cdp) {\n cdp.close();\n }\n // Don't kill Chrome - let user review and close manually\n }\n}\n\nfunction printUsage(): never {\n console.log(`Publish Markdown article to X (Twitter) Articles\n\nUsage:\n npx -y bun x-article.ts <markdown_file> [options]\n\nOptions:\n --title <title> Override title\n --cover <image> Override cover image\n --submit Actually publish (default: draft only)\n --profile <dir> Chrome profile directory\n --help Show this help\n\nMarkdown frontmatter:\n ---\n title: My Article Title\n cover_image: /path/to/cover.jpg\n ---\n\nExample:\n npx -y bun x-article.ts article.md\n npx -y bun x-article.ts article.md --cover ./hero.png\n npx -y bun x-article.ts article.md --submit\n`);\n process.exit(0);\n}\n\nasync function main(): Promise<void> {\n const args = process.argv.slice(2);\n if (args.length === 0 || args.includes('--help') || args.includes('-h')) {\n printUsage();\n }\n\n let markdownPath: string | undefined;\n let title: string | undefined;\n let coverImage: string | undefined;\n let submit = false;\n let profileDir: string | undefined;\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i]!;\n if (arg === '--title' && args[i + 1]) {\n title = args[++i];\n } else if (arg === '--cover' && args[i + 1]) {\n const raw = args[++i]!;\n coverImage = path.isAbsolute(raw) ? raw : path.resolve(process.cwd(), raw);\n } else if (arg === '--submit') {\n submit = true;\n } else if (arg === '--profile' && args[i + 1]) {\n profileDir = args[++i];\n } else if (!arg.startsWith('-')) {\n markdownPath = arg;\n }\n }\n\n if (!markdownPath) {\n console.error('Error: Markdown file path required');\n process.exit(1);\n }\n\n if (!fs.existsSync(markdownPath)) {\n console.error(`Error: File not found: ${markdownPath}`);\n process.exit(1);\n }\n\n await publishArticle({ markdownPath, title, coverImage, submit, profileDir });\n}\n\nawait main().catch((err) => {\n console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n});\n"
},
{
"path": "skills/obsidian-to-x/scripts/x-post.ts",
"content": "import { spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { mkdir } from 'node:fs/promises';\nimport process from 'node:process';\nimport {\n CHROME_CANDIDATES_FULL,\n CdpConnection,\n copyImageToClipboard,\n findChromeExecutable,\n getDefaultProfileDir,\n getFreePort,\n pasteFromClipboard,\n sleep,\n waitForChromeDebugPort,\n} from './x-utils.js';\n\nconst X_COMPOSE_URL = 'https://x.com/compose/post';\n\ninterface XBrowserOptions {\n text?: string;\n images?: string[];\n submit?: boolean;\n timeoutMs?: number;\n profileDir?: string;\n chromePath?: string;\n}\n\nexport async function postToX(options: XBrowserOptions): Promise<void> {\n const { text, images = [], submit = false, timeoutMs = 120_000, profileDir = getDefaultProfileDir() } = options;\n\n const chromePath = options.chromePath ?? findChromeExecutable(CHROME_CANDIDATES_FULL);\n if (!chromePath) throw new Error('Chrome not found. Set X_BROWSER_CHROME_PATH env var.');\n\n await mkdir(profileDir, { recursive: true });\n\n const port = await getFreePort();\n console.log(`[x-browser] Launching Chrome (profile: ${profileDir})`);\n\n const chrome = spawn(chromePath, [\n `--remote-debugging-port=${port}`,\n `--user-data-dir=${profileDir}`,\n '--no-first-run',\n '--no-default-browser-check',\n '--disable-blink-features=AutomationControlled',\n '--start-maximized',\n X_COMPOSE_URL,\n ], { stdio: 'ignore' });\n\n let cdp: CdpConnection | null = null;\n\n try {\n const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });\n cdp = await CdpConnection.connect(wsUrl, 30_000, { defaultTimeoutMs: 15_000 });\n\n const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');\n let pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.includes('x.com'));\n\n if (!pageTarget) {\n const { targetId } = await cdp.send<{ targetId: string }>('Target.createTarget', { url: X_COMPOSE_URL });\n pageTarget = { targetId, url: X_COMPOSE_URL, type: 'page' };\n }\n\n const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', { targetId: pageTarget.targetId, flatten: true });\n\n await cdp.send('Page.enable', {}, { sessionId });\n await cdp.send('Runtime.enable', {}, { sessionId });\n await cdp.send('Input.setIgnoreInputEvents', { ignore: false }, { sessionId });\n\n console.log('[x-browser] Waiting for X editor...');\n await sleep(3000);\n\n const waitForEditor = async (): Promise<boolean> => {\n const start = Date.now();\n while (Date.now() - start < timeoutMs) {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[data-testid=\"tweetTextarea_0\"]')`,\n returnByValue: true,\n }, { sessionId });\n if (result.result.value) return true;\n await sleep(1000);\n }\n return false;\n };\n\n const editorFound = await waitForEditor();\n if (!editorFound) {\n console.log('[x-browser] Editor not found. Please log in to X in the browser window.');\n console.log('[x-browser] Waiting for login...');\n const loggedIn = await waitForEditor();\n if (!loggedIn) throw new Error('Timed out waiting for X editor. Please log in first.');\n }\n\n if (text) {\n console.log('[x-browser] Typing text...');\n // Focus the editor first\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"tweetTextarea_0\"]')?.focus()`,\n }, { sessionId });\n await sleep(200);\n\n // Use Input.insertText to insert text (preserves newlines and special characters)\n await cdp.send('Input.insertText', { text }, { sessionId });\n await sleep(500);\n }\n\n // X Posts support max 4 images\n const maxImages = 4;\n const imagesToUpload = images.slice(0, maxImages);\n\n if (images.length > maxImages) {\n console.log(`[x-browser] Note: X Posts support max ${maxImages} images. Uploading first ${maxImages} of ${images.length} images.`);\n }\n\n for (const imagePath of imagesToUpload) {\n if (!fs.existsSync(imagePath)) {\n console.warn(`[x-browser] Image not found: ${imagePath}`);\n continue;\n }\n\n console.log(`[x-browser] Pasting image: ${imagePath}`);\n\n if (!copyImageToClipboard(imagePath)) {\n console.warn(`[x-browser] Failed to copy image to clipboard: ${imagePath}`);\n continue;\n }\n\n // Count uploaded images before paste\n const imgCountBefore = await cdp.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelectorAll('img[src^=\"blob:\"]').length`,\n returnByValue: true,\n }, { sessionId });\n\n // Wait for clipboard to be ready\n await sleep(500);\n\n // Focus the editor\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"tweetTextarea_0\"]')?.focus()`,\n }, { sessionId });\n await sleep(200);\n\n // Use paste script (handles platform differences, activates Chrome)\n console.log('[x-browser] Pasting from clipboard...');\n const pasteSuccess = pasteFromClipboard('Google Chrome', 5, 500);\n\n if (!pasteSuccess) {\n // Fallback to CDP (may not work for images on X)\n console.log('[x-browser] Paste script failed, trying CDP fallback...');\n const modifiers = process.platform === 'darwin' ? 4 : 2;\n await cdp.send('Input.dispatchKeyEvent', {\n type: 'keyDown',\n key: 'v',\n code: 'KeyV',\n modifiers,\n windowsVirtualKeyCode: 86,\n }, { sessionId });\n await cdp.send('Input.dispatchKeyEvent', {\n type: 'keyUp',\n key: 'v',\n code: 'KeyV',\n modifiers,\n windowsVirtualKeyCode: 86,\n }, { sessionId });\n }\n\n console.log('[x-browser] Verifying image upload...');\n const expectedImgCount = imgCountBefore.result.value + 1;\n let imgUploadOk = false;\n const imgWaitStart = Date.now();\n while (Date.now() - imgWaitStart < 15_000) {\n const r = await cdp!.send<{ result: { value: number } }>('Runtime.evaluate', {\n expression: `document.querySelectorAll('img[src^=\"blob:\"]').length`,\n returnByValue: true,\n }, { sessionId });\n if (r.result.value >= expectedImgCount) {\n imgUploadOk = true;\n break;\n }\n await sleep(1000);\n }\n\n if (imgUploadOk) {\n console.log('[x-browser] Image upload verified');\n } else {\n console.warn('[x-browser] Image upload not detected after 15s. Run check-paste-permissions.ts to diagnose.');\n }\n }\n\n // Scroll to show uploaded images after all images are uploaded\n if (imagesToUpload.length > 0) {\n console.log('[x-browser] Scrolling to show uploaded images...');\n await cdp.send('Runtime.evaluate', {\n expression: `\n // Try multiple strategies to scroll to bottom\n\n // Strategy 1: Scroll to the first uploaded image (most reliable)\n const uploadedImage = document.querySelector('img[src^=\"blob:\"]');\n if (uploadedImage) {\n uploadedImage.scrollIntoView({ behavior: 'smooth', block: 'center' });\n console.log('[scroll] Scrolled to uploaded image');\n } else {\n // Strategy 2: Scroll the main compose area\n const composeArea = document.querySelector('[data-testid=\"toolBar\"]')?.parentElement;\n if (composeArea) {\n composeArea.scrollTo({ top: composeArea.scrollHeight, behavior: 'smooth' });\n console.log('[scroll] Scrolled compose area to bottom');\n } else {\n // Strategy 3: Scroll window\n window.scrollBy({ top: 400, behavior: 'smooth' });\n console.log('[scroll] Scrolled window down 400px');\n }\n }\n `,\n }, { sessionId });\n await sleep(1000);\n }\n\n if (submit) {\n console.log('[x-browser] Submitting post...');\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"tweetButton\"]')?.click()`,\n }, { sessionId });\n await sleep(2000);\n console.log('[x-browser] Post submitted!');\n\n // Close browser after submission\n if (cdp) {\n try { await cdp.send('Browser.close', {}, { timeoutMs: 5_000 }); } catch {}\n }\n setTimeout(() => {\n if (!chrome.killed) try { chrome.kill('SIGKILL'); } catch {}\n }, 2_000).unref?.();\n try { chrome.kill('SIGTERM'); } catch {}\n } else {\n console.log('[x-browser] Post composed (preview mode). Add --submit to post.');\n console.log('[x-browser] Browser remains open for manual review.');\n }\n } finally {\n // Disconnect CDP but keep browser open in preview mode\n if (cdp) {\n cdp.close();\n }\n // Don't kill Chrome - let user review and close manually\n }\n}\n\nfunction printUsage(): never {\n console.log(`Post to X (Twitter) using real Chrome browser\n\nUsage:\n npx -y bun x-browser.ts [options] [text]\n\nOptions:\n --image <path> Add image (can be repeated, max 4)\n --submit Actually post (default: preview only)\n --profile <dir> Chrome profile directory\n --help Show this help\n\nExamples:\n npx -y bun x-browser.ts \"Hello from CLI!\"\n npx -y bun x-browser.ts \"Check this out\" --image ./screenshot.png\n npx -y bun x-browser.ts \"Post it!\" --image a.png --image b.png --submit\n`);\n process.exit(0);\n}\n\nasync function main(): Promise<void> {\n const args = process.argv.slice(2);\n if (args.includes('--help') || args.includes('-h')) printUsage();\n\n const images: string[] = [];\n let submit = false;\n let profileDir: string | undefined;\n const textParts: string[] = [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i]!;\n if (arg === '--image' && args[i + 1]) {\n images.push(args[++i]!);\n } else if (arg === '--submit') {\n submit = true;\n } else if (arg === '--profile' && args[i + 1]) {\n profileDir = args[++i];\n } else if (!arg.startsWith('-')) {\n textParts.push(arg);\n }\n }\n\n const text = textParts.join(' ').trim() || undefined;\n\n if (!text && images.length === 0) {\n console.error('Error: Provide text or at least one image.');\n process.exit(1);\n }\n\n await postToX({ text, images, submit, profileDir });\n}\n\nawait main().catch((err) => {\n console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n});\n"
},
{
"path": "skills/obsidian-to-x/scripts/x-quote.ts",
"content": "import { spawn } from 'node:child_process';\nimport { mkdir } from 'node:fs/promises';\nimport process from 'node:process';\nimport {\n CHROME_CANDIDATES_FULL,\n CdpConnection,\n findChromeExecutable,\n getDefaultProfileDir,\n getFreePort,\n sleep,\n waitForChromeDebugPort,\n} from './x-utils.js';\n\nfunction extractTweetUrl(urlOrId: string): string | null {\n // If it's already a full URL, normalize it\n if (urlOrId.match(/(?:x\\.com|twitter\\.com)\\/\\w+\\/status\\/\\d+/)) {\n return urlOrId.replace(/twitter\\.com/, 'x.com').split('?')[0];\n }\n return null;\n}\n\ninterface QuoteOptions {\n tweetUrl: string;\n comment?: string;\n submit?: boolean;\n timeoutMs?: number;\n profileDir?: string;\n chromePath?: string;\n}\n\nexport async function quotePost(options: QuoteOptions): Promise<void> {\n const { tweetUrl, comment, submit = false, timeoutMs = 120_000, profileDir = getDefaultProfileDir() } = options;\n\n const chromePath = options.chromePath ?? findChromeExecutable(CHROME_CANDIDATES_FULL);\n if (!chromePath) throw new Error('Chrome not found. Set X_BROWSER_CHROME_PATH env var.');\n\n await mkdir(profileDir, { recursive: true });\n\n const port = await getFreePort();\n console.log(`[x-quote] Launching Chrome (profile: ${profileDir})`);\n console.log(`[x-quote] Opening tweet: ${tweetUrl}`);\n\n const chrome = spawn(chromePath, [\n `--remote-debugging-port=${port}`,\n `--user-data-dir=${profileDir}`,\n '--no-first-run',\n '--no-default-browser-check',\n '--disable-blink-features=AutomationControlled',\n '--start-maximized',\n tweetUrl,\n ], { stdio: 'ignore' });\n\n let cdp: CdpConnection | null = null;\n\n try {\n const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });\n cdp = await CdpConnection.connect(wsUrl, 30_000, { defaultTimeoutMs: 15_000 });\n\n const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');\n let pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.includes('x.com'));\n\n if (!pageTarget) {\n const { targetId } = await cdp.send<{ targetId: string }>('Target.createTarget', { url: tweetUrl });\n pageTarget = { targetId, url: tweetUrl, type: 'page' };\n }\n\n const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', { targetId: pageTarget.targetId, flatten: true });\n\n await cdp.send('Page.enable', {}, { sessionId });\n await cdp.send('Runtime.enable', {}, { sessionId });\n\n console.log('[x-quote] Waiting for tweet to load...');\n await sleep(3000);\n\n // Wait for retweet button to appear (indicates tweet loaded and user logged in)\n const waitForRetweetButton = async (): Promise<boolean> => {\n const start = Date.now();\n while (Date.now() - start < timeoutMs) {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[data-testid=\"retweet\"]')`,\n returnByValue: true,\n }, { sessionId });\n if (result.result.value) return true;\n await sleep(1000);\n }\n return false;\n };\n\n const retweetFound = await waitForRetweetButton();\n if (!retweetFound) {\n console.log('[x-quote] Tweet not found or not logged in. Please log in to X in the browser window.');\n console.log('[x-quote] Waiting for login...');\n const loggedIn = await waitForRetweetButton();\n if (!loggedIn) throw new Error('Timed out waiting for tweet. Please log in first or check the tweet URL.');\n }\n\n // Click the retweet button\n console.log('[x-quote] Clicking retweet button...');\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"retweet\"]')?.click()`,\n }, { sessionId });\n await sleep(1000);\n\n // Wait for and click the \"Quote\" option in the menu\n console.log('[x-quote] Selecting quote option...');\n const waitForQuoteOption = async (): Promise<boolean> => {\n const start = Date.now();\n while (Date.now() - start < 10_000) {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[data-testid=\"Dropdown\"] [role=\"menuitem\"]:nth-child(2)')`,\n returnByValue: true,\n }, { sessionId });\n if (result.result.value) return true;\n await sleep(200);\n }\n return false;\n };\n\n const quoteOptionFound = await waitForQuoteOption();\n if (!quoteOptionFound) {\n throw new Error('Quote option not found. The menu may not have opened.');\n }\n\n // Click the quote option (second menu item)\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"Dropdown\"] [role=\"menuitem\"]:nth-child(2)')?.click()`,\n }, { sessionId });\n await sleep(2000);\n\n // Wait for the quote compose dialog\n console.log('[x-quote] Waiting for quote compose dialog...');\n const waitForQuoteDialog = async (): Promise<boolean> => {\n const start = Date.now();\n while (Date.now() - start < 10_000) {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[data-testid=\"tweetTextarea_0\"]')`,\n returnByValue: true,\n }, { sessionId });\n if (result.result.value) return true;\n await sleep(200);\n }\n return false;\n };\n\n const dialogFound = await waitForQuoteDialog();\n if (!dialogFound) {\n throw new Error('Quote compose dialog not found.');\n }\n\n // Type the comment if provided\n if (comment) {\n console.log('[x-quote] Typing comment...');\n // Use CDP Input.insertText for more reliable text insertion\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"tweetTextarea_0\"]')?.focus()`,\n }, { sessionId });\n await sleep(200);\n\n await cdp.send('Input.insertText', {\n text: comment,\n }, { sessionId });\n await sleep(500);\n }\n\n if (submit) {\n console.log('[x-quote] Submitting quote post...');\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"tweetButton\"]')?.click()`,\n }, { sessionId });\n await sleep(2000);\n console.log('[x-quote] Quote post submitted!');\n } else {\n console.log('[x-quote] Quote composed (preview mode). Add --submit to post.');\n console.log('[x-quote] Browser will stay open for 30 seconds for preview...');\n await sleep(30_000);\n }\n } finally {\n if (cdp) {\n try { await cdp.send('Browser.close', {}, { timeoutMs: 5_000 }); } catch {}\n cdp.close();\n }\n\n setTimeout(() => {\n if (!chrome.killed) try { chrome.kill('SIGKILL'); } catch {}\n }, 2_000).unref?.();\n try { chrome.kill('SIGTERM'); } catch {}\n }\n}\n\nfunction printUsage(): never {\n console.log(`Quote a tweet on X (Twitter) using real Chrome browser\n\nUsage:\n npx -y bun x-quote.ts <tweet-url> [options] [comment]\n\nOptions:\n --submit Actually post (default: preview only)\n --profile <dir> Chrome profile directory\n --help Show this help\n\nExamples:\n npx -y bun x-quote.ts https://x.com/user/status/123456789 \"Great insight!\"\n npx -y bun x-quote.ts https://x.com/user/status/123456789 \"I agree!\" --submit\n`);\n process.exit(0);\n}\n\nasync function main(): Promise<void> {\n const args = process.argv.slice(2);\n if (args.includes('--help') || args.includes('-h')) printUsage();\n\n let tweetUrl: string | undefined;\n let submit = false;\n let profileDir: string | undefined;\n const commentParts: string[] = [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i]!;\n if (arg === '--submit') {\n submit = true;\n } else if (arg === '--profile' && args[i + 1]) {\n profileDir = args[++i];\n } else if (!arg.startsWith('-')) {\n // First non-option argument is the tweet URL\n if (!tweetUrl && arg.match(/(?:x\\.com|twitter\\.com)\\/\\w+\\/status\\/\\d+/)) {\n tweetUrl = extractTweetUrl(arg) ?? undefined;\n } else {\n commentParts.push(arg);\n }\n }\n }\n\n if (!tweetUrl) {\n console.error('Error: Please provide a tweet URL.');\n console.error('Example: npx -y bun x-quote.ts https://x.com/user/status/123456789 \"Your comment\"');\n process.exit(1);\n }\n\n const comment = commentParts.join(' ').trim() || undefined;\n\n await quotePost({ tweetUrl, comment, submit, profileDir });\n}\n\nawait main().catch((err) => {\n console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n});\n"
},
{
"path": "skills/obsidian-to-x/scripts/x-utils.ts",
"content": "import { execSync, spawnSync } from 'node:child_process';\nimport fs from 'node:fs';\nimport net from 'node:net';\nimport os from 'node:os';\nimport path from 'node:path';\nimport process from 'node:process';\nimport { fileURLToPath } from 'node:url';\n\nexport type PlatformCandidates = {\n darwin?: string[];\n win32?: string[];\n default: string[];\n};\n\nexport const CHROME_CANDIDATES_BASIC: PlatformCandidates = {\n darwin: [\n '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',\n '/Applications/Chromium.app/Contents/MacOS/Chromium',\n ],\n win32: [\n 'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n 'C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n ],\n default: [\n '/usr/bin/google-chrome',\n '/usr/bin/chromium',\n '/usr/bin/chromium-browser',\n ],\n};\n\nexport const CHROME_CANDIDATES_FULL: PlatformCandidates = {\n darwin: [\n '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',\n '/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta',\n '/Applications/Chromium.app/Contents/MacOS/Chromium',\n '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',\n ],\n win32: [\n 'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n 'C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n 'C:\\\\Program Files\\\\Microsoft\\\\Edge\\\\Application\\\\msedge.exe',\n 'C:\\\\Program Files (x86)\\\\Microsoft\\\\Edge\\\\Application\\\\msedge.exe',\n ],\n default: [\n '/usr/bin/google-chrome',\n '/usr/bin/google-chrome-stable',\n '/usr/bin/chromium',\n '/usr/bin/chromium-browser',\n '/snap/bin/chromium',\n '/usr/bin/microsoft-edge',\n ],\n};\n\nfunction getCandidatesForPlatform(candidates: PlatformCandidates): string[] {\n if (process.platform === 'darwin' && candidates.darwin?.length) return candidates.darwin;\n if (process.platform === 'win32' && candidates.win32?.length) return candidates.win32;\n return candidates.default;\n}\n\nexport function findChromeExecutable(candidates: PlatformCandidates): string | undefined {\n const override = process.env.X_BROWSER_CHROME_PATH?.trim();\n if (override && fs.existsSync(override)) return override;\n\n for (const candidate of getCandidatesForPlatform(candidates)) {\n if (fs.existsSync(candidate)) return candidate;\n }\n return undefined;\n}\n\nlet _wslHome: string | null | undefined;\nfunction getWslWindowsHome(): string | null {\n if (_wslHome !== undefined) return _wslHome;\n if (!process.env.WSL_DISTRO_NAME) { _wslHome = null; return null; }\n try {\n const raw = execSync('cmd.exe /C \"echo %USERPROFILE%\"', { encoding: 'utf-8', timeout: 5000 }).trim().replace(/\\r/g, '');\n _wslHome = execSync(`wslpath -u \"${raw}\"`, { encoding: 'utf-8', timeout: 5000 }).trim() || null;\n } catch { _wslHome = null; }\n return _wslHome;\n}\n\nexport function getDefaultProfileDir(): string {\n const override = process.env.LIBUKAI_CHROME_PROFILE_DIR?.trim() || process.env.X_BROWSER_PROFILE_DIR?.trim();\n if (override) return path.resolve(override);\n const wslHome = getWslWindowsHome();\n if (wslHome) return path.join(wslHome, '.local', 'share', 'libukai-skills', 'chrome-profile');\n const base = process.platform === 'darwin'\n ? path.join(os.homedir(), 'Library', 'Application Support')\n : process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');\n return path.join(base, 'libukai-skills', 'chrome-profile');\n}\n\nexport function sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport async function getFreePort(): Promise<number> {\n const fixed = parseInt(process.env.X_BROWSER_DEBUG_PORT || '', 10);\n if (fixed > 0) return fixed;\n return new Promise((resolve, reject) => {\n const server = net.createServer();\n server.unref();\n server.on('error', reject);\n server.listen(0, '127.0.0.1', () => {\n const address = server.address();\n if (!address || typeof address === 'string') {\n server.close(() => reject(new Error('Unable to allocate a free TCP port.')));\n return;\n }\n const port = address.port;\n server.close((err) => {\n if (err) reject(err);\n else resolve(port);\n });\n });\n });\n}\n\nasync function fetchJson<T = unknown>(url: string): Promise<T> {\n const res = await fetch(url, { redirect: 'follow' });\n if (!res.ok) throw new Error(`Request failed: ${res.status} ${res.statusText}`);\n return (await res.json()) as T;\n}\n\nexport async function waitForChromeDebugPort(\n port: number,\n timeoutMs: number,\n options?: { includeLastError?: boolean },\n): Promise<string> {\n const start = Date.now();\n let lastError: unknown = null;\n\n while (Date.now() - start < timeoutMs) {\n try {\n const version = await fetchJson<{ webSocketDebuggerUrl?: string }>(`http://127.0.0.1:${port}/json/version`);\n if (version.webSocketDebuggerUrl) return version.webSocketDebuggerUrl;\n lastError = new Error('Missing webSocketDebuggerUrl');\n } catch (error) {\n lastError = error;\n }\n await sleep(200);\n }\n\n if (options?.includeLastError && lastError) {\n throw new Error(`Chrome debug port not ready: ${lastError instanceof Error ? lastError.message : String(lastError)}`);\n }\n throw new Error('Chrome debug port not ready');\n}\n\ntype PendingRequest = {\n resolve: (value: unknown) => void;\n reject: (error: Error) => void;\n timer: ReturnType<typeof setTimeout> | null;\n};\n\nexport class CdpConnection {\n private ws: WebSocket;\n private nextId = 0;\n private pending = new Map<number, PendingRequest>();\n private eventHandlers = new Map<string, Set<(params: unknown) => void>>();\n private defaultTimeoutMs: number;\n\n private constructor(ws: WebSocket, options?: { defaultTimeoutMs?: number }) {\n this.ws = ws;\n this.defaultTimeoutMs = options?.defaultTimeoutMs ?? 15_000;\n\n this.ws.addEventListener('message', (event) => {\n try {\n const data = typeof event.data === 'string' ? event.data : new TextDecoder().decode(event.data as ArrayBuffer);\n const msg = JSON.parse(data) as { id?: number; method?: string; params?: unknown; result?: unknown; error?: { message?: string } };\n\n if (msg.method) {\n const handlers = this.eventHandlers.get(msg.method);\n if (handlers) handlers.forEach((h) => h(msg.params));\n }\n\n if (msg.id) {\n const pending = this.pending.get(msg.id);\n if (pending) {\n this.pending.delete(msg.id);\n if (pending.timer) clearTimeout(pending.timer);\n if (msg.error?.message) pending.reject(new Error(msg.error.message));\n else pending.resolve(msg.result);\n }\n }\n } catch {}\n });\n\n this.ws.addEventListener('close', () => {\n for (const [id, pending] of this.pending.entries()) {\n this.pending.delete(id);\n if (pending.timer) clearTimeout(pending.timer);\n pending.reject(new Error('CDP connection closed.'));\n }\n });\n }\n\n static async connect(url: string, timeoutMs: number, options?: { defaultTimeoutMs?: number }): Promise<CdpConnection> {\n const ws = new WebSocket(url);\n await new Promise<void>((resolve, reject) => {\n const timer = setTimeout(() => reject(new Error('CDP connection timeout.')), timeoutMs);\n ws.addEventListener('open', () => { clearTimeout(timer); resolve(); });\n ws.addEventListener('error', () => { clearTimeout(timer); reject(new Error('CDP connection failed.')); });\n });\n return new CdpConnection(ws, options);\n }\n\n on(method: string, handler: (params: unknown) => void): void {\n if (!this.eventHandlers.has(method)) this.eventHandlers.set(method, new Set());\n this.eventHandlers.get(method)!.add(handler);\n }\n\n async send<T = unknown>(method: string, params?: Record<string, unknown>, options?: { sessionId?: string; timeoutMs?: number }): Promise<T> {\n const id = ++this.nextId;\n const message: Record<string, unknown> = { id, method };\n if (params) message.params = params;\n if (options?.sessionId) message.sessionId = options.sessionId;\n\n const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;\n\n const result = await new Promise<unknown>((resolve, reject) => {\n const timer = timeoutMs > 0\n ? setTimeout(() => { this.pending.delete(id); reject(new Error(`CDP timeout: ${method}`)); }, timeoutMs)\n : null;\n this.pending.set(id, { resolve, reject, timer });\n this.ws.send(JSON.stringify(message));\n });\n\n return result as T;\n }\n\n close(): void {\n try { this.ws.close(); } catch {}\n }\n}\n\nexport function getScriptDir(): string {\n return path.dirname(fileURLToPath(import.meta.url));\n}\n\nfunction runBunScript(scriptPath: string, args: string[]): boolean {\n const result = spawnSync('npx', ['-y', 'bun', scriptPath, ...args], { stdio: 'inherit' });\n return result.status === 0;\n}\n\nexport function copyImageToClipboard(imagePath: string): boolean {\n const copyScript = path.join(getScriptDir(), 'copy-to-clipboard.ts');\n return runBunScript(copyScript, ['image', imagePath]);\n}\n\nexport function copyHtmlToClipboard(htmlPath: string): boolean {\n const copyScript = path.join(getScriptDir(), 'copy-to-clipboard.ts');\n return runBunScript(copyScript, ['html', '--file', htmlPath]);\n}\n\nexport function pasteFromClipboard(targetApp?: string, retries = 3, delayMs = 500): boolean {\n const pasteScript = path.join(getScriptDir(), 'paste-from-clipboard.ts');\n const args = ['--retries', String(retries), '--delay', String(delayMs)];\n if (targetApp) args.push('--app', targetApp);\n return runBunScript(pasteScript, args);\n}\n"
},
{
"path": "skills/obsidian-to-x/scripts/x-video.ts",
"content": "import { spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { mkdir } from 'node:fs/promises';\nimport path from 'node:path';\nimport process from 'node:process';\nimport {\n CHROME_CANDIDATES_FULL,\n CdpConnection,\n findChromeExecutable,\n getDefaultProfileDir,\n getFreePort,\n sleep,\n waitForChromeDebugPort,\n} from './x-utils.js';\n\nconst X_COMPOSE_URL = 'https://x.com/compose/post';\n\ninterface XVideoOptions {\n text?: string;\n videoPath: string;\n submit?: boolean;\n timeoutMs?: number;\n profileDir?: string;\n chromePath?: string;\n}\n\nexport async function postVideoToX(options: XVideoOptions): Promise<void> {\n const { text, videoPath, submit = false, timeoutMs = 120_000, profileDir = getDefaultProfileDir() } = options;\n\n const chromePath = options.chromePath ?? findChromeExecutable(CHROME_CANDIDATES_FULL);\n if (!chromePath) throw new Error('Chrome not found. Set X_BROWSER_CHROME_PATH env var.');\n\n if (!fs.existsSync(videoPath)) throw new Error(`Video not found: ${videoPath}`);\n\n const absVideoPath = path.resolve(videoPath);\n console.log(`[x-video] Video: ${absVideoPath}`);\n\n await mkdir(profileDir, { recursive: true });\n\n const port = await getFreePort();\n console.log(`[x-video] Launching Chrome (profile: ${profileDir})`);\n\n const chrome = spawn(chromePath, [\n `--remote-debugging-port=${port}`,\n `--user-data-dir=${profileDir}`,\n '--no-first-run',\n '--no-default-browser-check',\n '--disable-blink-features=AutomationControlled',\n '--start-maximized',\n X_COMPOSE_URL,\n ], { stdio: 'ignore' });\n\n let cdp: CdpConnection | null = null;\n\n try {\n const wsUrl = await waitForChromeDebugPort(port, 30_000, { includeLastError: true });\n cdp = await CdpConnection.connect(wsUrl, 30_000, { defaultTimeoutMs: 30_000 });\n\n const targets = await cdp.send<{ targetInfos: Array<{ targetId: string; url: string; type: string }> }>('Target.getTargets');\n let pageTarget = targets.targetInfos.find((t) => t.type === 'page' && t.url.includes('x.com'));\n\n if (!pageTarget) {\n const { targetId } = await cdp.send<{ targetId: string }>('Target.createTarget', { url: X_COMPOSE_URL });\n pageTarget = { targetId, url: X_COMPOSE_URL, type: 'page' };\n }\n\n const { sessionId } = await cdp.send<{ sessionId: string }>('Target.attachToTarget', { targetId: pageTarget.targetId, flatten: true });\n\n await cdp.send('Page.enable', {}, { sessionId });\n await cdp.send('Runtime.enable', {}, { sessionId });\n await cdp.send('DOM.enable', {}, { sessionId });\n await cdp.send('Input.setIgnoreInputEvents', { ignore: false }, { sessionId });\n\n console.log('[x-video] Waiting for X editor...');\n await sleep(3000);\n\n const waitForEditor = async (): Promise<boolean> => {\n const start = Date.now();\n while (Date.now() - start < timeoutMs) {\n const result = await cdp!.send<{ result: { value: boolean } }>('Runtime.evaluate', {\n expression: `!!document.querySelector('[data-testid=\"tweetTextarea_0\"]')`,\n returnByValue: true,\n }, { sessionId });\n if (result.result.value) return true;\n await sleep(1000);\n }\n return false;\n };\n\n const editorFound = await waitForEditor();\n if (!editorFound) {\n console.log('[x-video] Editor not found. Please log in to X in the browser window.');\n console.log('[x-video] Waiting for login...');\n const loggedIn = await waitForEditor();\n if (!loggedIn) throw new Error('Timed out waiting for X editor. Please log in first.');\n }\n\n // Upload video FIRST (before typing text to avoid text being cleared)\n console.log('[x-video] Uploading video...');\n\n const { root } = await cdp.send<{ root: { nodeId: number } }>('DOM.getDocument', {}, { sessionId });\n const { nodeId } = await cdp.send<{ nodeId: number }>('DOM.querySelector', {\n nodeId: root.nodeId,\n selector: 'input[type=\"file\"][accept*=\"video\"], input[data-testid=\"fileInput\"], input[type=\"file\"]',\n }, { sessionId });\n\n if (!nodeId || nodeId === 0) {\n throw new Error('Could not find file input for video upload.');\n }\n\n await cdp.send('DOM.setFileInputFiles', {\n nodeId,\n files: [absVideoPath],\n }, { sessionId });\n console.log('[x-video] Video file set, uploading in background...');\n\n // Wait a moment for upload to start, then type text while video processes\n await sleep(2000);\n\n // Type text while video uploads in background\n if (text) {\n console.log('[x-video] Typing text...');\n await cdp.send('Runtime.evaluate', {\n expression: `\n const editor = document.querySelector('[data-testid=\"tweetTextarea_0\"]');\n if (editor) {\n editor.focus();\n document.execCommand('insertText', false, ${JSON.stringify(text)});\n }\n `,\n }, { sessionId });\n await sleep(500);\n }\n\n // Wait for video to finish processing by checking if tweet button is enabled\n console.log('[x-video] Waiting for video processing...');\n const waitForVideoReady = async (maxWaitMs = 180_000): Promise<boolean> => {\n const start = Date.now();\n let dots = 0;\n while (Date.now() - start < maxWaitMs) {\n const result = await cdp!.send<{ result: { value: { hasMedia: boolean; buttonEnabled: boolean } } }>('Runtime.evaluate', {\n expression: `(() => {\n const hasMedia = !!document.querySelector('[data-testid=\"attachments\"] video, [data-testid=\"videoPlayer\"], video');\n const tweetBtn = document.querySelector('[data-testid=\"tweetButton\"]');\n const buttonEnabled = tweetBtn && !tweetBtn.disabled && tweetBtn.getAttribute('aria-disabled') !== 'true';\n return { hasMedia, buttonEnabled };\n })()`,\n returnByValue: true,\n }, { sessionId });\n\n const { hasMedia, buttonEnabled } = result.result.value;\n if (hasMedia && buttonEnabled) {\n console.log('');\n return true;\n }\n\n process.stdout.write('.');\n dots++;\n if (dots % 60 === 0) console.log(''); // New line every 60 dots\n await sleep(2000);\n }\n console.log('');\n return false;\n };\n\n const videoReady = await waitForVideoReady();\n if (videoReady) {\n console.log('[x-video] Video ready!');\n } else {\n console.log('[x-video] Video may still be processing. Please check browser window.');\n }\n\n if (submit) {\n console.log('[x-video] Submitting post...');\n await cdp.send('Runtime.evaluate', {\n expression: `document.querySelector('[data-testid=\"tweetButton\"]')?.click()`,\n }, { sessionId });\n await sleep(5000);\n console.log('[x-video] Post submitted!');\n } else {\n console.log('[x-video] Post composed (preview mode). Add --submit to post.');\n console.log('[x-video] Browser stays open for review.');\n }\n } finally {\n if (cdp) {\n cdp.close();\n }\n // Don't kill Chrome in preview mode, let user review\n if (submit) {\n setTimeout(() => {\n if (!chrome.killed) try { chrome.kill('SIGKILL'); } catch {}\n }, 2_000).unref?.();\n try { chrome.kill('SIGTERM'); } catch {}\n }\n }\n}\n\nfunction printUsage(): never {\n console.log(`Post video to X (Twitter) using real Chrome browser\n\nUsage:\n npx -y bun x-video.ts [options] --video <path> [text]\n\nOptions:\n --video <path> Video file path (required, supports mp4/mov/webm)\n --submit Actually post (default: preview only)\n --profile <dir> Chrome profile directory\n --help Show this help\n\nExamples:\n npx -y bun x-video.ts --video ./clip.mp4 \"Check out this video!\"\n npx -y bun x-video.ts --video ./demo.mp4 --submit\n npx -y bun x-video.ts --video ./video.mp4 \"Multi-line text\nworks too\"\n\nNotes:\n - Video is uploaded first, then text is added (to avoid text being cleared)\n - Video processing may take 30-60 seconds depending on file size\n - Maximum video length on X: 140 seconds (regular) or 60 min (Premium)\n - Supported formats: MP4, MOV, WebM\n`);\n process.exit(0);\n}\n\nasync function main(): Promise<void> {\n const args = process.argv.slice(2);\n if (args.includes('--help') || args.includes('-h')) printUsage();\n\n let videoPath: string | undefined;\n let submit = false;\n let profileDir: string | undefined;\n const textParts: string[] = [];\n\n for (let i = 0; i < args.length; i++) {\n const arg = args[i]!;\n if (arg === '--video' && args[i + 1]) {\n videoPath = args[++i]!;\n } else if (arg === '--submit') {\n submit = true;\n } else if (arg === '--profile' && args[i + 1]) {\n profileDir = args[++i];\n } else if (!arg.startsWith('-')) {\n textParts.push(arg);\n }\n }\n\n const text = textParts.join(' ').trim() || undefined;\n\n if (!videoPath) {\n console.error('Error: --video <path> is required.');\n printUsage();\n }\n\n await postVideoToX({ text, videoPath, submit, profileDir });\n}\n\nawait main().catch((err) => {\n console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);\n process.exit(1);\n});\n"
}
]