{"id":"188c1dd4-2659-4881-9be2-4700f428f68e","entityType":"agent","slug":"clawhub-jimliu-baoyu-post-to-x","name":"Baoyu Post To X","canonicalUrl":"https://www.xpersona.co/agent/clawhub-jimliu-baoyu-post-to-x","canonicalPath":"/agent/clawhub-jimliu-baoyu-post-to-x","generatedAt":"2026-10-10T00:50:18.167Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:05:54.645Z","emptyReason":null},"description":"Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). In Codex, honor explicit requests f...","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 4.6K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17dfbhg0khk4fvtnx0stqg0yx83j25z:baoyu-post-to-x","sourceUrl":"https://clawhub.ai/jimliu/baoyu-post-to-x","homepage":"https://clawhub.ai/jimliu/skills/baoyu-post-to-x","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/jimliu/baoyu-post-to-x","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/jimliu/skills/baoyu-post-to-x","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":73,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Baoyu Post To X technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:05:54.645Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:05:54.645Z","emptyReason":null},"stars":null,"forks":null,"downloads":4608,"packageName":null,"latestVersion":"1.58.1","tractionLabel":"4.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:05:54.644Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T05:05:54.645Z","lastCrawledAt":"2026-10-09T05:05:54.644Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T05:05:54.644Z","lastVerifiedAt":null,"highlights":[{"version":"1.58.1","createdAt":"2026-06-01T03:31:29.739Z","changelog":"Fix stale npm shared package dependency pins for baoyu-md and baoyu-chrome-cdp 0.1.1.","fileCount":18,"zipByteSize":59419},{"version":"1.57.2","createdAt":"2026-05-24T22:09:44.592Z","changelog":"baoyu-post-to-x 1.57.2 - Major update: Adds explicit multi-path execution instructions for posts to X (Codex Chrome plugin, Chrome Computer Use, or CDP script), with clear rules for each. - Now honors user preference for Codex Chrome plugin/@chrome and gives detailed instructions for Chrome extension automation, permissions, and error handling. - Introduces a dedicated script for checking paste/file-upload permissions. - Updates documentation: improved clarity on file/script paths, runtime selection, and X Article image flows. - Enhances EXTEND.md preference order and scope explanation. - Adds test coverage for utility functions.","fileCount":17,"zipByteSize":55450},{"version":"0.1.0","createdAt":"2026-02-05T03:44:38.722Z","changelog":"Initial release of baoyu-post-to-x – post content, images, videos, and articles to X (Twitter) using real Chrome automation. - Supports regular posts (text + up to 4 images), video uploads, quote tweets, and X Articles (Markdown long-form, for Premium users). - Uses Chrome CDP to bypass anti-automation measures. - Includes script directory layout and agent execution instructions. - Preferences and custom settings supported via EXTEND.md at project or user level. - First-time login to X is interactive and session persists for later use. - Reference guides provided for troubleshooting and article workflow.","fileCount":12,"zipByteSize":35490}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17dfbhg0khk4fvtnx0stqg0yx83j25z:baoyu-post-to-x","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17dfbhg0khk4fvtnx0stqg0yx83j25z:baoyu-post-to-x` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/jimliu/baoyu-post-to-x before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T00:50:18.166Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-jimliu-baoyu-post-to-x/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T05:05:54.645Z","emptyReason":null},"readme":"Skill: Baoyu Post To X\n\nOwner: jimliu\n\nSummary: Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). In Codex, honor explicit requests f...\n\nTags: latest:1.58.1\n\nVersion history:\n\nv1.58.1 | 2026-06-01T03:31:29.739Z | user\n\nFix stale npm shared package dependency pins for baoyu-md and baoyu-chrome-cdp 0.1.1.\n\nv1.57.2 | 2026-05-24T22:09:44.592Z | auto\n\nbaoyu-post-to-x 1.57.2\n\n- Major update: Adds explicit multi-path execution instructions for posts to X (Codex Chrome plugin, Chrome Computer Use, or CDP script), with clear rules for each.\n- Now honors user preference for Codex Chrome plugin/@chrome and gives detailed instructions for Chrome extension automation, permissions, and error handling.\n- Introduces a dedicated script for checking paste/file-upload permissions.\n- Updates documentation: improved clarity on file/script paths, runtime selection, and X Article image flows.\n- Enhances EXTEND.md preference order and scope explanation.\n- Adds test coverage for utility functions.\n\nv0.1.0 | 2026-02-05T03:44:38.722Z | auto\n\nInitial release of baoyu-post-to-x – post content, images, videos, and articles to X (Twitter) using real Chrome automation.\n\n- Supports regular posts (text + up to 4 images), video uploads, quote tweets, and X Articles (Markdown long-form, for Premium users).\n- Uses Chrome CDP to bypass anti-automation measures.\n- Includes script directory layout and agent execution instructions.\n- Preferences and custom settings supported via EXTEND.md at project or user level.\n- First-time login to X is interactive and session persists for later use.\n- Reference guides provided for troubleshooting and article workflow.\n\nArchive index:\n\nArchive v1.58.1: 18 files, 59419 bytes\n\nFiles: references/articles.md (13457b), references/regular-posts.md (4132b), scripts/bun.lock (23955b), scripts/check-paste-permissions.ts (8310b), scripts/copy-to-clipboard.ts (12179b), scripts/md-to-html.test.ts (3017b), scripts/md-to-html.ts (12505b), scripts/package.json (379b), scripts/paste-from-clipboard.ts (5659b), scripts/x-article.ts (31699b), scripts/x-browser.ts (9002b), scripts/x-quote.ts (9112b), scripts/x-utils.test.ts (1676b), scripts/x-utils.ts (8817b), scripts/x-video.ts (9536b), skill-card.md (2977b), SKILL.md (17668b), _meta.json (135b)\n\nFile v1.58.1:SKILL.md\n\n---\nname: baoyu-post-to-x\ndescription: Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). In Codex, honor explicit requests for the Codex Chrome plugin/@chrome by using the Chrome Extension workflow; otherwise use Chrome Computer Use when available and fall back to real Chrome CDP scripts only when allowed. Use when user asks to \"post to X\", \"tweet\", \"publish to Twitter\", or \"share on X\".\nversion: 1.58.1\nmetadata:\n openclaw:\n homepage: https://github.com/JimLiu/baoyu-skills#baoyu-post-to-x\n requires:\n anyBins:\n - bun\n - npx\n---\n\n# Post to X (Twitter)\n\nPosts text, images, videos, and long-form articles to X via a real Chrome browser.\n\nIn Codex, do not conflate these browser paths:\n- **Codex Chrome plugin / `@chrome` / Chrome Extension**: use the bundled `chrome:Chrome` skill and its Node REPL browser client. This is required whenever the user says \"Codex Chrome plugin\", \"Codex 自带的 Chrome 插件\", `@chrome`, or similar.\n- **Chrome Computer Use**: use `mcp__computer_use__.*` against the visible Google Chrome UI only when the user asks for Computer Use or no Chrome-plugin preference is stated and Computer Use is available.\n- **CDP script mode**: use only as a fallback when the selected mode is unavailable or the user explicitly asks for CDP/script mode.\n\n## Script Directory\n\n**Important**: All scripts are located in the `scripts/` subdirectory of this skill.\n\n**Agent Execution Instructions**:\n1. Determine this SKILL.md file's directory path as `{baseDir}`\n2. Script path = `{baseDir}/scripts/.ts`\n3. Replace all `{baseDir}` in this document with the actual path\n4. Resolve `${BUN_X}` runtime: if `bun` installed → `bun`; if `npx` available → `npx -y bun`; else suggest installing bun\n\n**Script Reference**:\n| Script | Purpose |\n|--------|---------|\n| `scripts/x-browser.ts` | Regular posts (text + images), CDP fallback |\n| `scripts/x-video.ts` | Video posts (text + video), CDP fallback |\n| `scripts/x-quote.ts` | Quote tweet with comment, CDP fallback |\n| `scripts/x-article.ts` | Long-form article publishing (Markdown), CDP fallback |\n| `scripts/md-to-html.ts` | Markdown → HTML conversion |\n| `scripts/copy-to-clipboard.ts` | Copy content to clipboard |\n| `scripts/paste-from-clipboard.ts` | Send real paste keystroke |\n| `scripts/check-paste-permissions.ts` | Verify environment & permissions |\n\n## Execution Mode Selection (Required)\n\nChoose exactly one mode before interacting with X:\n\n1. If the user explicitly asks for the Codex Chrome plugin, `@chrome`, the Chrome extension, or \"Codex 自带的 Chrome 插件\", use **Codex Chrome Plugin Mode**. Do not call Computer Use first.\n2. If the user explicitly asks for Chrome Computer Use, use **Chrome Computer Use Mode**. Do not fall back to CDP, Playwright, the in-app Browser, or the Chrome plugin without telling the user and getting approval.\n3. If the user explicitly asks for CDP/script mode, use **CDP Script Mode**.\n4. Otherwise, prefer **Chrome Computer Use Mode**. For Markdown **X Articles with local content images**, use the tested X editor flow: insert each body image from the toolbar (`Insert` -> `Media` -> dialog icon button `Add photos or video`) at its placeholder, then delete the placeholder text. Use CDP Script Mode only when the selected browser-control mode is unavailable or the UI upload/selection flow is unreliable.\n\nNever use the in-app Browser for X publishing workflows.\n\n## Codex Chrome Plugin Mode\n\nUse this mode whenever the user requests the Codex Chrome plugin, `@chrome`, or the Chrome Extension path. This uses the user's real Chrome profile and X login through the bundled Chrome plugin, not Computer Use and not CDP.\n\n**Setup**\n1. Load the `chrome:Chrome` skill before browser work.\n2. Use `tool_search` for `node_repl js` if the Node REPL `js` tool is not already visible.\n3. Initialize the Chrome browser client exactly as the Chrome skill specifies, then run a lightweight call such as `browser.user.openTabs()` to verify the extension connection.\n4. If the first lightweight call fails, wait 2 seconds and retry once. If it still fails, follow the Chrome skill's extension checks and recovery steps. If checks pass but communication still fails, ask the user before opening a new Chrome window. Do not switch to Computer Use or CDP silently.\n\n**General rules**\n- Use the Chrome plugin's `browser.tabs.*`, `tab.playwright.*`, `tab.cua.*`, and file chooser APIs for X UI actions.\n- Shell commands are allowed for Markdown preprocessing and rich-HTML clipboard preparation. For X Article body images, do not rely on image clipboard paste; use the editor's `Insert` -> `Media` upload flow.\n- If a file upload fails with `Not allowed`, tell the user: `To enable file upload, go to chrome://extensions in Chrome, click Details under the Codex extension, and enable \"Allow access to file URLs.\" See https://developers.openai.com/codex/app/chrome-extension#upload-files for details.`\n- If the Chrome plugin reports `native pipe is closed`, retry the lightweight browser call once after 2 seconds, then run the Chrome skill health checks. If Chrome is running, the extension is enabled, and the native host manifest is correct, ask permission to open a new Chrome window and retry. Do not keep sending browser actions through the broken pipe.\n- Never click `Publish`, `Post`, or any externally visible submit action without explicit final confirmation from the user in the current conversation.\n\n**X Articles**\n1. Convert Markdown and keep the image map:\n ```bash\n ${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/x-article-body.html > /tmp/x-article.json\n ```\n2. Read the JSON output for `title`, `coverImage`, and `contentImages` (`placeholder` → `localPath`).\n3. Open or create the article draft at `https://x.com/compose/articles`.\n4. Upload the cover with the Chrome plugin file chooser flow. If upload is blocked by extension permissions, stop and report the exact permission fix above.\n5. Fill the title, then copy rich HTML:\n ```bash\n ${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/x-article-body.html\n ```\n6. Paste into the article body with a real paste keystroke through the Chrome plugin. On macOS use `Meta+V`.\n7. Verify the editor text contains the article body and `XIMGPH_` placeholders. Do not rely on `tab.clipboard.readText()` as proof of the system clipboard after shell clipboard writes; on macOS verify with `pbpaste` if needed.\n8. For each `contentImages` item in placeholder order:\n - Locate the visible placeholder text (`XIMGPH_N`) and click it to place the caret there.\n - Open the toolbar menu `Insert` -> `Media`.\n - In the modal, click the icon button with `aria-label=\"Add photos or video\"`; do not click the text/dropzone or hidden file input.\n - Use the file chooser to upload that image's `localPath`.\n - After the image appears, if `XIMGPH_N` remains above it, select exactly that placeholder and press `Delete` first. Use `Backspace` only if `Delete` fails and the selected text is confirmed to be exactly the placeholder.\n - Verify the placeholder count for that `XIMGPH_N` is `0`.\n9. Open Preview and verify title, cover, body, links, and images.\n10. Ask for explicit confirmation before clicking `Publish`.\n\n## Preferences (EXTEND.md)\n\nCheck EXTEND.md in priority order — the first one found wins:\n\n| Priority | Path | Scope |\n|----------|------|-------|\n| 1 | `.baoyu-skills/baoyu-post-to-x/EXTEND.md` | Project |\n| 2 | `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-post-to-x/EXTEND.md` | XDG |\n| 3 | `$HOME/.baoyu-skills/baoyu-post-to-x/EXTEND.md` | User home |\n\nIf none found, use defaults.\n\n**EXTEND.md supports**: Default Chrome profile\n\n## Prerequisites\n\n- Google Chrome or Chromium\n- `bun` runtime\n- First run: log in to X manually (session saved)\n\n## Pre-flight Check (Optional)\n\nBefore first use, suggest running the environment check. User can skip if they prefer.\n\n```bash\n${BUN_X} {baseDir}/scripts/check-paste-permissions.ts\n```\n\nChecks: Chrome, profile isolation, Bun, Accessibility, clipboard, paste keystroke, Chrome conflicts.\n\n**If any check fails**, provide fix guidance per item:\n\n| Check | Fix |\n|-------|-----|\n| Chrome | Install Chrome or set `X_BROWSER_CHROME_PATH` env var |\n| Profile dir | Shared profile at `baoyu-skills/chrome-profile` (see CLAUDE.md Chrome Profile section) |\n| Bun runtime | `brew install oven-sh/bun/bun` (macOS) or `npm install -g bun` |\n| Accessibility (macOS) | System Settings → Privacy & Security → Accessibility → enable terminal app |\n| Clipboard copy | Ensure Swift/AppKit available (macOS Xcode CLI tools: `xcode-select --install`) |\n| Paste keystroke (macOS) | Same as Accessibility fix above |\n| Paste keystroke (Linux) | Install `xdotool` (X11) or `ydotool` (Wayland) |\n\n## References\n\n- **Regular Posts**: See `references/regular-posts.md` for manual workflow, troubleshooting, and technical details\n- **X Articles**: See `references/articles.md` for long-form article publishing guide\n\n---\n\n## Chrome Computer Use Mode\n\nUse this mode when the user explicitly asks for Chrome Computer Use, or when no Chrome-plugin preference is stated and Codex can control `Google Chrome` with Computer Use. This uses the user's existing Chrome window, cookies, login, extensions, and X session.\n\n**General rules**:\n- Start each assistant turn that controls Chrome by calling `get_app_state` for `Google Chrome`.\n- Prefer element-index actions when available; use coordinates only for editor text selection or drag selection.\n- Do not use the in-app Browser, the Chrome plugin, Playwright, or CDP for X UI actions in this mode unless the user approves a mode change.\n- Never click `Publish`, `Post`, or any externally visible submit action without an explicit final confirmation from the user in the current conversation.\n\n**Regular posts**:\n1. Open or navigate Chrome to `https://x.com/compose/post`.\n2. Type the post text into the composer using Computer Use.\n3. For each image, run:\n ```bash\n ${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts image /absolute/path/to/image.png\n ```\n4. Paste with Computer Use (`super+v` on macOS, `control+v` on Windows/Linux), then wait until X finishes uploading media.\n5. Ask for confirmation before clicking `Post`.\n\n**Video posts**:\n1. Open or navigate Chrome to `https://x.com/compose/post`.\n2. Type the post text into the composer.\n3. Use the visible media upload/file picker UI to attach the video.\n4. Wait for upload and processing to complete.\n5. Ask for confirmation before clicking `Post`.\n\n**Quote tweets**:\n1. Open the tweet URL in Chrome.\n2. Use the visible quote/repost UI to choose Quote.\n3. Type the comment.\n4. Ask for confirmation before clicking `Post`.\n\n**X Articles**:\n1. Convert Markdown and keep the image map:\n ```bash\n ${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/x-article-body.html > /tmp/x-article.json\n ```\n2. Read the JSON output for `title`, `coverImage`, and `contentImages` (`placeholder` → `localPath`).\n3. In Chrome, open `https://x.com/compose/articles`, create or open the draft, upload the cover if present, and fill the title.\n4. Copy rich HTML to the clipboard:\n ```bash\n ${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/x-article-body.html\n ```\n5. Paste into the article body with Computer Use.\n6. For each `contentImages` entry in placeholder order:\n - Locate the exact visible placeholder text such as `XIMGPH_3` and click it to set the insertion point.\n - Open the toolbar `Insert` dropdown, choose `Media`, then click the modal's icon button labeled `Add photos or video`.\n - Use the native file picker to choose the image's `localPath`.\n - Wait until the image block appears and any upload activity is finished.\n - If the placeholder remains above the inserted image, reselect exactly that placeholder text and press `Delete` first. Use `Backspace` only if `Delete` fails and the selected text is confirmed to be exactly the placeholder.\n7. Verify no `XIMGPH_` placeholders remain and the expected images appear.\n8. Open Preview and verify title, cover, body, links, and images.\n9. Ask for explicit confirmation before clicking `Publish`.\n\nIf Computer Use selection, toolbar upload, or file-picker control becomes unreliable, stop and report the blocker instead of switching to the Chrome plugin or CDP silently.\n\n---\n\n## CDP Script Mode (Fallback)\n\nUse the script sections below only when the selected browser-control mode is unavailable, unreliable, or explicitly not requested. These scripts launch or reuse a real Chrome instance via CDP and keep the browser open for review.\n\nDo not use CDP Script Mode when the user explicitly requires the Codex Chrome plugin or Chrome Computer Use unless the user approves the fallback after you explain the blocker.\n\n---\n\n## Post Type Selection\n\nUnless the user explicitly specifies the post type:\n- **Plain text** + within 10,000 characters → **Regular Post** (Premium members support up to 10,000 characters, non-Premium: 280)\n- **Markdown file** (.md) → **X Article**\n\n## Regular Posts\n\n```bash\n${BUN_X} {baseDir}/scripts/x-browser.ts \"Hello!\" --image ./photo.png\n```\n\n**Parameters**:\n| Parameter | Description |\n|-----------|-------------|\n| `` | Post content (positional) |\n| `--image ` | Image file (repeatable, max 4) |\n| `--profile ` | Custom Chrome profile |\n\n**Note**: Script opens browser with content filled in. User reviews and publishes manually.\n\n**Codex mode note**: If the user explicitly requested the Codex Chrome plugin, use **Codex Chrome Plugin Mode**. Otherwise, if Chrome Computer Use is enabled, use **Chrome Computer Use Mode** instead of running `x-browser.ts`.\n\n---\n\n## Video Posts\n\nText + video file.\n\n```bash\n${BUN_X} {baseDir}/scripts/x-video.ts \"Check this out!\" --video ./clip.mp4\n```\n\n**Parameters**:\n| Parameter | Description |\n|-----------|-------------|\n| `` | Post content (positional) |\n| `--video ` | Video file (MP4, MOV, WebM) |\n| `--profile ` | Custom Chrome profile |\n\n**Note**: Script opens browser with content filled in. User reviews and publishes manually.\n\n**Codex mode note**: If the user explicitly requested the Codex Chrome plugin, use **Codex Chrome Plugin Mode**. Otherwise, if Chrome Computer Use is enabled, use **Chrome Computer Use Mode** instead of running `x-video.ts`.\n\n**Limits**: Regular 140s max, Premium 60min. Processing: 30-60s.\n\n---\n\n## Quote Tweets\n\nQuote an existing tweet with comment.\n\n```bash\n${BUN_X} {baseDir}/scripts/x-quote.ts https://x.com/user/status/123 \"Great insight!\"\n```\n\n**Parameters**:\n| Parameter | Description |\n|-----------|-------------|\n| `` | URL to quote (positional) |\n| `` | Comment text (positional, optional) |\n| `--profile ` | Custom Chrome profile |\n\n**Note**: Script opens browser with content filled in. User reviews and publishes manually.\n\n**Codex mode note**: If the user explicitly requested the Codex Chrome plugin, use **Codex Chrome Plugin Mode**. Otherwise, if Chrome Computer Use is enabled, use **Chrome Computer Use Mode** instead of running `x-quote.ts`.\n\n---\n\n## X Articles\n\nLong-form Markdown articles (requires X Premium).\n\n```bash\n${BUN_X} {baseDir}/scripts/x-article.ts article.md\n${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg\n```\n\n**Parameters**:\n| Parameter | Description |\n|-----------|-------------|\n| `` | Markdown file (positional) |\n| `--cover ` | Cover image |\n| `--title ` | Override title |\n\n**Frontmatter**: `title`, `cover_image` supported in YAML front matter.\n\n**Codex mode note**: If the user explicitly requested the Codex Chrome plugin, follow **Codex Chrome Plugin Mode** above. If the user explicitly requested Chrome Computer Use, follow **Chrome Computer Use Mode**. Otherwise, prefer Chrome Computer Use; for Markdown articles with local content images, use the toolbar `Insert` -> `Media` image-upload workflow before falling back to `x-article.ts` in **CDP Script Mode**.\n\n**CDP fallback note**: The script opens browser with article filled in. User reviews and publishes manually unless `--submit` is used.\n\n**Publish safety**: Do not use `--submit` or click `Publish` unless the user explicitly confirms the final public publish action.\n\n**Post-Composition Check**: The 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---\n\n## Troubleshooting\n\n### Chrome debug port not ready\n\nCDP fallback only: if a script fails with `Chrome debug port not ready` or `Unable to connect`, kill existing Chrome CDP instances first, then retry:\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 — when encountering this error, kill Chrome CDP instances and retry the command without asking the user.\n\n## Notes\n\n- First run: manual login required (session persists)\n- In Codex Chrome Plugin Mode and Chrome Computer Use Mode, use the user's existing Chrome session and do not launch a separate CDP profile\n- CDP scripts only fill content into the browser by default; user must review and publish manually unless `--submit` is explicitly used\n- Cross-platform: macOS, Linux, Windows\n\n## Extension Support\n\nCustom configurations via EXTEND.md. See **Preferences** section for paths and supported options.\n\nFile v1.58.1:_meta.json\n\n{\n \"ownerId\": \"kn7csrrndw79hpke5d0gsnx93d82k67r\",\n \"slug\": \"baoyu-post-to-x\",\n \"version\": \"1.58.1\",\n \"publishedAt\": 1780284689739\n}\n\nFile v1.58.1:references/articles.md\n\n# X Articles - Detailed Guide\n\nPublish Markdown articles to X Articles editor with rich text formatting and images.\n\n## Mode Selection\n\nIn Codex, choose the browser-control mode from the user's wording:\n\n1. If the user says \"Codex Chrome plugin\", \"Codex 自带的 Chrome 插件\", `@chrome`, or Chrome Extension, use **Codex Chrome Plugin Workflow**. Do not try Computer Use first.\n2. If the user explicitly asks for Chrome Computer Use, use **Computer Use Workflow**.\n3. If the user explicitly asks for CDP/script mode, use **CDP Script Workflow**.\n4. Otherwise, use Computer Use when available; if unavailable or blocked, use CDP Script Workflow.\n\nNever use the in-app Browser for X Article publishing. Never switch away from an explicitly requested mode without explaining the blocker and getting approval.\n\n## Prerequisites\n\n- X Premium subscription (required for Articles)\n- Google Chrome installed\n- `bun` installed\n\n## Usage\n\n### Codex Chrome Plugin (When Requested)\n\nUse the `chrome:Chrome` skill and its Node REPL browser client. Verify the connection with a lightweight call such as `browser.user.openTabs()`. If it fails, wait 2 seconds and retry once, then follow the Chrome skill's health checks.\n\nPrepare the article HTML and image map:\n\n```bash\n${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/x-article-body.html > /tmp/x-article.json\n```\n\nCopy generated HTML as rich text:\n\n```bash\n${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/x-article-body.html\n```\n\nUse the Chrome plugin's tab, Playwright-wrapper, CUA, clipboard, and file chooser APIs for all X UI operations. If upload fails with `Not allowed`, stop and tell the user to enable file URL access for the Codex Chrome Extension in `chrome://extensions` → Details.\n\n### Chrome Computer Use\n\nPrepare the article HTML and image map:\n\n```bash\n${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/x-article-body.html > /tmp/x-article.json\n```\n\nCopy the generated HTML as rich text:\n\n```bash\n${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/x-article-body.html\n```\n\nThen use Codex Computer Use against `Google Chrome` for all X UI operations.\n\n### CDP Script Fallback\n\n```bash\n# Publish markdown article (preview mode)\n${BUN_X} {baseDir}/scripts/x-article.ts article.md\n\n# With custom cover image\n${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg\n\n# Actually publish\n${BUN_X} {baseDir}/scripts/x-article.ts article.md --submit\n```\n\nDo not use `--submit` unless the user has explicitly confirmed the final public publish action.\n\n## Markdown Format\n\n```markdown\n---\ntitle: My Article Title\ncover_image: /path/to/cover.jpg\n---\n\n# Title (becomes article title)\n\nRegular paragraph text with **bold** and *italic*.\n\n## Section Header\n\nMore content here.\n\n![Image alt text](./image.png)\n\n- List item 1\n- List item 2\n\n1. Numbered item\n2. Another item\n\n> Blockquote text\n\n[Link text](https://example.com)\n\n\\`\\`\\`\nCode blocks become blockquotes (X doesn't support code)\n\\`\\`\\`\n```\n\n## Frontmatter Fields\n\n| Field | Description |\n|-------|-------------|\n| `title` | Article title (or uses first H1) |\n| `cover_image` | Cover image path or URL |\n| `cover` | Alias for cover_image |\n| `image` | Alias for cover_image |\n\n## Image Handling\n\n1. **Cover Image**: First image or `cover_image` from frontmatter\n2. **Remote Images**: Automatically downloaded to temp directory\n3. **Placeholders**: Images in content use `XIMGPH_N` format\n4. **Insertion**: Placeholders are found, selected, and replaced with actual images\n\n## Markdown to HTML Script\n\nConvert markdown and inspect structure:\n\n```bash\n# Get JSON with all metadata\n${BUN_X} {baseDir}/scripts/md-to-html.ts article.md\n\n# Output HTML only\n${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --html-only\n\n# Save HTML to file\n${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/article.html\n```\n\nJSON output:\n```json\n{\n \"title\": \"Article Title\",\n \"coverImage\": \"/path/to/cover.jpg\",\n \"contentImages\": [\n {\n \"placeholder\": \"XIMGPH_1\",\n \"localPath\": \"/tmp/x-article-images/img.png\",\n \"blockIndex\": 5\n }\n ],\n \"html\": \"

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` | `

` |\n| `**bold**` | `` |\n| `*italic*` | `` |\n| `[text](url)` | `` |\n| `> quote` | `
` |\n| `` `code` `` | `` |\n| ```` ``` ```` | `
` (X limitation) |\n| `- item` | `