[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F72BRCRS77PPJSHHH6H1KB":3,"skill-same:01M7F72BRCRS77PPJSHHH6H1KB":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":40,"commitSha":41,"skillDirectory":42,"forksCount":43,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M7F72BRCRS77PPJSHHH6H1KB","xurl",null,"A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.","lza6\u002FArmor-piercing-system-prompts","lza6","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F128880206?v=4","01M7EB3K7WPX5T28EJ2NVHE6EG","Chinese-tingfeng","01M7EB3K97E1KQ16QWKJMFNGX8",11,"MIT","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F05-技能与代理开发\u002Fxurl\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: xurl\ndescription: A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.\nmetadata:\n  {\n    \"understudy\":\n      {\n        \"emoji\": \"𝕏\",\n        \"requires\": { \"bins\": [\"xurl\"] },\n        \"install\":\n          [\n            {\n              \"id\": \"brew\",\n              \"kind\": \"brew\",\n              \"formula\": \"xdevplatform\u002Ftap\u002Fxurl\",\n              \"bins\": [\"xurl\"],\n              \"label\": \"Install xurl (brew)\",\n            },\n            {\n              \"id\": \"npm\",\n              \"kind\": \"npm\",\n              \"package\": \"@xdevplatform\u002Fxurl\",\n              \"bins\": [\"xurl\"],\n              \"label\": \"Install xurl (npm)\",\n            },\n          ],\n      },\n  }\n---\n\n# xurl — Agent Skill Reference\n\n`xurl` is a CLI tool for the X API. It supports both **shortcut commands** (human\u002Fagent‑friendly one‑liners) and **raw curl‑style** access to any v2 endpoint. All commands return JSON to stdout.\n\n---\n\n## Installation\n\n### Homebrew (macOS)\n\n```bash\nbrew install --cask xdevplatform\u002Ftap\u002Fxurl\n```\n\n### npm\n\n```bash\nnpm install -g @xdevplatform\u002Fxurl\n```\n\n### Shell script\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fxdevplatform\u002Fxurl\u002Fmain\u002Finstall.sh | bash\n```\n\nInstalls to `~\u002F.local\u002Fbin`. If it's not in your PATH, the script will tell you what to add.\n\n### Go\n\n```bash\ngo install github.com\u002Fxdevplatform\u002Fxurl@latest\n```\n\n---\n\n## Prerequisites\n\nThis skill requires the `xurl` CLI utility: \u003Chttps:\u002F\u002Fgithub.com\u002Fxdevplatform\u002Fxurl>.\n\nBefore using any command you must be authenticated. Run `xurl auth status` to check.\n\n### Secret Safety (Mandatory)\n\n- Never read, print, parse, summarize, upload, or send `~\u002F.xurl` (or copies of it) to the LLM context.\n- Never ask the user to paste credentials\u002Ftokens into chat.\n- The user must fill `~\u002F.xurl` with required secrets manually on their own machine.\n- Do not recommend or execute auth commands with inline secrets in agent\u002FLLM sessions.\n- Warn that using CLI secret options in agent sessions can leak credentials (prompt\u002Fcontext, logs, shell history).\n- Never use `--verbose` \u002F `-v` in agent\u002FLLM sessions; it can expose sensitive headers\u002Ftokens in output.\n- Sensitive flags that must never be used in agent commands: `--bearer-token`, `--consumer-key`, `--consumer-secret`, `--access-token`, `--token-secret`, `--client-id`, `--client-secret`.\n- To verify whether at least one app with credentials is already registered, run: `xurl auth status`.\n\n### Register an app (recommended)\n\nApp credential registration must be done manually by the user outside the agent\u002FLLM session.\nAfter credentials are registered, authenticate with:\n\n```bash\nxurl auth oauth2\n```\n\nFor multiple pre-configured apps, switch between them:\n\n```bash\nxurl auth default prod-app          # set default app\nxurl auth default prod-app alice    # set default app + user\nxurl --app dev-app \u002F2\u002Fusers\u002Fme      # one-off override\n```\n\n### Other auth methods\n\nExamples with inline secret flags are intentionally omitted. If OAuth1 or app-only auth is needed, the user must run those commands manually outside agent\u002FLLM context.\n\nTokens are persisted to `~\u002F.xurl` in YAML format. Each app has its own isolated tokens. Do not read this file through the agent\u002FLLM. Once authenticated, every command below will auto‑attach the right `Authorization` header.\n\n---\n\n## Quick Reference\n\n| Action                    | Command                                               |\n| ------------------------- | ----------------------------------------------------- |\n| Post                      | `xurl post \"Hello world!\"`                            |\n| Reply                     | `xurl reply POST_ID \"Nice post!\"`                     |\n| Quote                     | `xurl quote POST_ID \"My take\"`                        |\n| Delete a post             | `xurl delete POST_ID`                                 |\n| Read a post               | `xurl read POST_ID`                                   |\n| Search posts              | `xurl search \"QUERY\" -n 10`                           |\n| Who am I                  | `xurl whoami`                                         |\n| Look up a user            | `xurl user @handle`                                   |\n| Home timeline             | `xurl timeline -n 20`                                 |\n| Mentions                  | `xurl mentions -n 10`                                 |\n| Like                      | `xurl like POST_ID`                                   |\n| Unlike                    | `xurl unlike POST_ID`                                 |\n| Repost                    | `xurl repost POST_ID`                                 |\n| Undo repost               | `xurl unrepost POST_ID`                               |\n| Bookmark                  | `xurl bookmark POST_ID`                               |\n| Remove bookmark           | `xurl unbookmark POST_ID`                             |\n| List bookmarks            | `xurl bookmarks -n 10`                                |\n| List likes                | `xurl likes -n 10`                                    |\n| Follow                    | `xurl follow @handle`                                 |\n| Unfollow                  | `xurl unfollow @handle`                               |\n| List following            | `xurl following -n 20`                                |\n| List followers            | `xurl followers -n 20`                                |\n| Block                     | `xurl block @handle`                                  |\n| Unblock                   | `xurl unblock @handle`                                |\n| Mute                      | `xurl mute @handle`                                   |\n| Unmute                    | `xurl unmute @handle`                                 |\n| Send DM                   | `xurl dm @handle \"message\"`                           |\n| List DMs                  | `xurl dms -n 10`                                      |\n| Upload media              | `xurl media upload path\u002Fto\u002Ffile.mp4`                  |\n| Media status              | `xurl media status MEDIA_ID`                          |\n| **App Management**        |                                                       |\n| Register app              | Manual, outside agent (do not pass secrets via agent) |\n| List apps                 | `xurl auth apps list`                                 |\n| Update app creds          | Manual, outside agent (do not pass secrets via agent) |\n| Remove app                | `xurl auth apps remove NAME`                          |\n| Set default (interactive) | `xurl auth default`                                   |\n| Set default (command)     | `xurl auth default APP_NAME [USERNAME]`               |\n| Use app per-request       | `xurl --app NAME \u002F2\u002Fusers\u002Fme`                         |\n| Auth status               | `xurl auth status`                                    |\n\n> **Post IDs vs URLs:** Anywhere `POST_ID` appears above you can also paste a full post URL (e.g. `https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890`) — xurl extracts the ID automatically.\n\n> **Usernames:** Leading `@` is optional. `@elonmusk` and `elonmusk` both work.\n\n---\n\n## Command Details\n\n### Posting\n\n```bash\n# Simple post\nxurl post \"Hello world!\"\n\n# Post with media (upload first, then attach)\nxurl media upload photo.jpg          # → note the media_id from response\nxurl post \"Check this out\" --media-id MEDIA_ID\n\n# Multiple media\nxurl post \"Thread pics\" --media-id 111 --media-id 222\n\n# Reply to a post (by ID or URL)\nxurl reply 1234567890 \"Great point!\"\nxurl reply https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890 \"Agreed!\"\n\n# Reply with media\nxurl reply 1234567890 \"Look at this\" --media-id MEDIA_ID\n\n# Quote a post\nxurl quote 1234567890 \"Adding my thoughts\"\n\n# Delete your own post\nxurl delete 1234567890\n```\n\n### Reading\n\n```bash\n# Read a single post (returns author, text, metrics, entities)\nxurl read 1234567890\nxurl read https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890\n\n# Search recent posts (default 10 results)\nxurl search \"golang\"\nxurl search \"from:elonmusk\" -n 20\nxurl search \"#buildinpublic lang:en\" -n 15\n```\n\n### User Info\n\n```bash\n# Your own profile\nxurl whoami\n\n# Look up any user\nxurl user elonmusk\nxurl user @XDevelopers\n```\n\n### Timelines & Mentions\n\n```bash\n# Home timeline (reverse chronological)\nxurl timeline\nxurl timeline -n 25\n\n# Your mentions\nxurl mentions\nxurl mentions -n 20\n```\n\n### Engagement\n\n```bash\n# Like \u002F unlike\nxurl like 1234567890\nxurl unlike 1234567890\n\n# Repost \u002F undo\nxurl repost 1234567890\nxurl unrepost 1234567890\n\n# Bookmark \u002F remove\nxurl bookmark 1234567890\nxurl unbookmark 1234567890\n\n# List your bookmarks \u002F likes\nxurl bookmarks -n 20\nxurl likes -n 20\n```\n\n### Social Graph\n\n```bash\n# Follow \u002F unfollow\nxurl follow @XDevelopers\nxurl unfollow @XDevelopers\n\n# List who you follow \u002F your followers\nxurl following -n 50\nxurl followers -n 50\n\n# List another user's following\u002Ffollowers\nxurl following --of elonmusk -n 20\nxurl followers --of elonmusk -n 20\n\n# Block \u002F unblock\nxurl block @spammer\nxurl unblock @spammer\n\n# Mute \u002F unmute\nxurl mute @annoying\nxurl unmute @annoying\n```\n\n### Direct Messages\n\n```bash\n# Send a DM\nxurl dm @someuser \"Hey, saw your post!\"\n\n# List recent DM events\nxurl dms\nxurl dms -n 25\n```\n\n### Media Upload\n\n```bash\n# Upload a file (auto‑detects type for images\u002Fvideos)\nxurl media upload photo.jpg\nxurl media upload video.mp4\n\n# Specify type and category explicitly\nxurl media upload --media-type image\u002Fjpeg --category tweet_image photo.jpg\n\n# Check processing status (videos need server‑side processing)\nxurl media status MEDIA_ID\nxurl media status --wait MEDIA_ID    # poll until done\n\n# Full workflow: upload then post\nxurl media upload meme.png           # response includes media id\nxurl post \"lol\" --media-id MEDIA_ID\n```\n\n---\n\n## Global Flags\n\nThese flags work on every command:\n\n| Flag         | Short | Description                                                        |\n| ------------ | ----- | ------------------------------------------------------------------ |\n| `--app`      |       | Use a specific registered app for this request (overrides default) |\n| `--auth`     |       | Force auth type: `oauth1`, `oauth2`, or `app`                      |\n| `--username` | `-u`  | Which OAuth2 account to use (if you have multiple)                 |\n| `--verbose`  | `-v`  | Forbidden in agent\u002FLLM sessions (can leak auth headers\u002Ftokens)     |\n| `--trace`    | `-t`  | Add `X-B3-Flags: 1` trace header                                   |\n\n---\n\n## Raw API Access\n\nThe shortcut commands cover the most common operations. For anything else, use xurl's raw curl‑style mode — it works with **any** X API v2 endpoint:\n\n```bash\n# GET request (default)\nxurl \u002F2\u002Fusers\u002Fme\n\n# POST with JSON body\nxurl -X POST \u002F2\u002Ftweets -d '{\"text\":\"Hello world!\"}'\n\n# PUT, PATCH, DELETE\nxurl -X DELETE \u002F2\u002Ftweets\u002F1234567890\n\n# Custom headers\nxurl -H \"Content-Type: application\u002Fjson\" \u002F2\u002Fsome\u002Fendpoint\n\n# Force streaming mode\nxurl -s \u002F2\u002Ftweets\u002Fsearch\u002Fstream\n\n# Full URLs also work\nxurl https:\u002F\u002Fapi.x.com\u002F2\u002Fusers\u002Fme\n```\n\n---\n\n## Streaming\n\nStreaming endpoints are auto‑detected. Known streaming endpoints include:\n\n- `\u002F2\u002Ftweets\u002Fsearch\u002Fstream`\n- `\u002F2\u002Ftweets\u002Fsample\u002Fstream`\n- `\u002F2\u002Ftweets\u002Fsample10\u002Fstream`\n\nYou can force streaming on any endpoint with `-s`:\n\n```bash\nxurl -s \u002F2\u002Fsome\u002Fendpoint\n```\n\n---\n\n## Output Format\n\nAll commands return **JSON** to stdout, pretty‑printed with syntax highlighting. The output structure matches the X API v2 response format. A typical response looks like:\n\n```json\n{\n  \"data\": {\n    \"id\": \"1234567890\",\n    \"text\": \"Hello world!\"\n  }\n}\n```\n\nErrors are also returned as JSON:\n\n```json\n{\n  \"errors\": [\n    {\n      \"message\": \"Not authorized\",\n      \"code\": 403\n    }\n  ]\n}\n```\n\n---\n\n## Common Workflows\n\n### Post with an image\n\n```bash\n# 1. Upload the image\nxurl media upload photo.jpg\n# 2. Copy the media_id from the response, then post\nxurl post \"Check out this photo!\" --media-id MEDIA_ID\n```\n\n### Reply to a conversation\n\n```bash\n# 1. Read the post to understand context\nxurl read https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890\n# 2. Reply\nxurl reply 1234567890 \"Here are my thoughts...\"\n```\n\n### Search and engage\n\n```bash\n# 1. Search for relevant posts\nxurl search \"topic of interest\" -n 10\n# 2. Like an interesting one\nxurl like POST_ID_FROM_RESULTS\n# 3. Reply to it\nxurl reply POST_ID_FROM_RESULTS \"Great point!\"\n```\n\n### Check your activity\n\n```bash\n# See who you are\nxurl whoami\n# Check your mentions\nxurl mentions -n 20\n# Check your timeline\nxurl timeline -n 20\n```\n\n### Set up multiple apps\n\n```bash\n# App credentials must already be configured manually outside agent\u002FLLM context.\n# Authenticate users on each pre-configured app\nxurl auth default prod\nxurl auth oauth2                       # authenticates on prod app\n\nxurl auth default staging\nxurl auth oauth2                       # authenticates on staging app\n\n# Switch between them\nxurl auth default prod alice           # prod app, alice user\nxurl --app staging \u002F2\u002Fusers\u002Fme         # one-off request against staging\n```\n\n---\n\n## Error Handling\n\n- Non‑zero exit code on any error.\n- API errors are printed as JSON to stdout (so you can still parse them).\n- Auth errors suggest re‑running `xurl auth oauth2` or checking your tokens.\n- If a command requires your user ID (like, repost, bookmark, follow, etc.), xurl will automatically fetch it via `\u002F2\u002Fusers\u002Fme`. If that fails, you'll see an auth error.\n\n---\n\n## Notes\n\n- **Rate limits:** The X API enforces rate limits per endpoint. If you get a 429 error, wait and retry. Write endpoints (post, reply, like, repost) have stricter limits than read endpoints.\n- **Scopes:** OAuth 2.0 tokens are requested with broad scopes. If you get a 403 on a specific action, your token may lack the required scope — re‑run `xurl auth oauth2` to get a fresh token.\n- **Token refresh:** OAuth 2.0 tokens auto‑refresh when expired. No manual intervention needed.\n- **Multiple apps:** Each app has its own isolated credentials and tokens. Configure credentials manually outside agent\u002FLLM context, then switch with `xurl auth default` or `--app`.\n- **Multiple accounts:** You can authenticate multiple OAuth 2.0 accounts per app and switch between them with `--username` \u002F `-u` or set a default with `xurl auth default APP USER`.\n- **Default user:** When no `-u` flag is given, xurl uses the default user for the active app (set via `xurl auth default`). If no default user is set, it uses the first available token.\n- **Token storage:** `~\u002F.xurl` is YAML. Each app stores its own credentials and tokens. Never read or send this file to LLM context.\n","# xurl — Agent Skill Reference\n\n`xurl` is a CLI tool for the X API. It supports both **shortcut commands** (human\u002Fagent‑friendly one‑liners) and **raw curl‑style** access to any v2 endpoint. All commands return JSON to stdout.\n\n---\n\n## Installation\n\n### Homebrew (macOS)\n\n```bash\nbrew install --cask xdevplatform\u002Ftap\u002Fxurl\n```\n\n### npm\n\n```bash\nnpm install -g @xdevplatform\u002Fxurl\n```\n\n### Shell script\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fxdevplatform\u002Fxurl\u002Fmain\u002Finstall.sh | bash\n```\n\nInstalls to `~\u002F.local\u002Fbin`. If it's not in your PATH, the script will tell you what to add.\n\n### Go\n\n```bash\ngo install github.com\u002Fxdevplatform\u002Fxurl@latest\n```\n\n---\n\n## Prerequisites\n\nThis skill requires the `xurl` CLI utility: \u003Chttps:\u002F\u002Fgithub.com\u002Fxdevplatform\u002Fxurl>.\n\nBefore using any command you must be authenticated. Run `xurl auth status` to check.\n\n### Secret Safety (Mandatory)\n\n- Never read, print, parse, summarize, upload, or send `~\u002F.xurl` (or copies of it) to the LLM context.\n- Never ask the user to paste credentials\u002Ftokens into chat.\n- The user must fill `~\u002F.xurl` with required secrets manually on their own machine.\n- Do not recommend or execute auth commands with inline secrets in agent\u002FLLM sessions.\n- Warn that using CLI secret options in agent sessions can leak credentials (prompt\u002Fcontext, logs, shell history).\n- Never use `--verbose` \u002F `-v` in agent\u002FLLM sessions; it can expose sensitive headers\u002Ftokens in output.\n- Sensitive flags that must never be used in agent commands: `--bearer-token`, `--consumer-key`, `--consumer-secret`, `--access-token`, `--token-secret`, `--client-id`, `--client-secret`.\n- To verify whether at least one app with credentials is already registered, run: `xurl auth status`.\n\n### Register an app (recommended)\n\nApp credential registration must be done manually by the user outside the agent\u002FLLM session.\nAfter credentials are registered, authenticate with:\n\n```bash\nxurl auth oauth2\n```\n\nFor multiple pre-configured apps, switch between them:\n\n```bash\nxurl auth default prod-app          # set default app\nxurl auth default prod-app alice    # set default app + user\nxurl --app dev-app \u002F2\u002Fusers\u002Fme      # one-off override\n```\n\n### Other auth methods\n\nExamples with inline secret flags are intentionally omitted. If OAuth1 or app-only auth is needed, the user must run those commands manually outside agent\u002FLLM context.\n\nTokens are persisted to `~\u002F.xurl` in YAML format. Each app has its own isolated tokens. Do not read this file through the agent\u002FLLM. Once authenticated, every command below will auto‑attach the right `Authorization` header.\n\n---\n\n## Quick Reference\n\n| Action                    | Command                                               |\n| ------------------------- | ----------------------------------------------------- |\n| Post                      | `xurl post \"Hello world!\"`                            |\n| Reply                     | `xurl reply POST_ID \"Nice post!\"`                     |\n| Quote                     | `xurl quote POST_ID \"My take\"`                        |\n| Delete a post             | `xurl delete POST_ID`                                 |\n| Read a post               | `xurl read POST_ID`                                   |\n| Search posts              | `xurl search \"QUERY\" -n 10`                           |\n| Who am I                  | `xurl whoami`                                         |\n| Look up a user            | `xurl user @handle`                                   |\n| Home timeline             | `xurl timeline -n 20`                                 |\n| Mentions                  | `xurl mentions -n 10`                                 |\n| Like                      | `xurl like POST_ID`                                   |\n| Unlike                    | `xurl unlike POST_ID`                                 |\n| Repost                    | `xurl repost POST_ID`                                 |\n| Undo repost               | `xurl unrepost POST_ID`                               |\n| Bookmark                  | `xurl bookmark POST_ID`                               |\n| Remove bookmark           | `xurl unbookmark POST_ID`                             |\n| List bookmarks            | `xurl bookmarks -n 10`                                |\n| List likes                | `xurl likes -n 10`                                    |\n| Follow                    | `xurl follow @handle`                                 |\n| Unfollow                  | `xurl unfollow @handle`                               |\n| List following            | `xurl following -n 20`                                |\n| List followers            | `xurl followers -n 20`                                |\n| Block                     | `xurl block @handle`                                  |\n| Unblock                   | `xurl unblock @handle`                                |\n| Mute                      | `xurl mute @handle`                                   |\n| Unmute                    | `xurl unmute @handle`                                 |\n| Send DM                   | `xurl dm @handle \"message\"`                           |\n| List DMs                  | `xurl dms -n 10`                                      |\n| Upload media              | `xurl media upload path\u002Fto\u002Ffile.mp4`                  |\n| Media status              | `xurl media status MEDIA_ID`                          |\n| **App Management**        |                                                       |\n| Register app              | Manual, outside agent (do not pass secrets via agent) |\n| List apps                 | `xurl auth apps list`                                 |\n| Update app creds          | Manual, outside agent (do not pass secrets via agent) |\n| Remove app                | `xurl auth apps remove NAME`                          |\n| Set default (interactive) | `xurl auth default`                                   |\n| Set default (command)     | `xurl auth default APP_NAME [USERNAME]`               |\n| Use app per-request       | `xurl --app NAME \u002F2\u002Fusers\u002Fme`                         |\n| Auth status               | `xurl auth status`                                    |\n\n> **Post IDs vs URLs:** Anywhere `POST_ID` appears above you can also paste a full post URL (e.g. `https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890`) — xurl extracts the ID automatically.\n\n> **Usernames:** Leading `@` is optional. `@elonmusk` and `elonmusk` both work.\n\n---\n\n## Command Details\n\n### Posting\n\n```bash\n# Simple post\nxurl post \"Hello world!\"\n\n# Post with media (upload first, then attach)\nxurl media upload photo.jpg          # → note the media_id from response\nxurl post \"Check this out\" --media-id MEDIA_ID\n\n# Multiple media\nxurl post \"Thread pics\" --media-id 111 --media-id 222\n\n# Reply to a post (by ID or URL)\nxurl reply 1234567890 \"Great point!\"\nxurl reply https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890 \"Agreed!\"\n\n# Reply with media\nxurl reply 1234567890 \"Look at this\" --media-id MEDIA_ID\n\n# Quote a post\nxurl quote 1234567890 \"Adding my thoughts\"\n\n# Delete your own post\nxurl delete 1234567890\n```\n\n### Reading\n\n```bash\n# Read a single post (returns author, text, metrics, entities)\nxurl read 1234567890\nxurl read https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890\n\n# Search recent posts (default 10 results)\nxurl search \"golang\"\nxurl search \"from:elonmusk\" -n 20\nxurl search \"#buildinpublic lang:en\" -n 15\n```\n\n### User Info\n\n```bash\n# Your own profile\nxurl whoami\n\n# Look up any user\nxurl user elonmusk\nxurl user @XDevelopers\n```\n\n### Timelines & Mentions\n\n```bash\n# Home timeline (reverse chronological)\nxurl timeline\nxurl timeline -n 25\n\n# Your mentions\nxurl mentions\nxurl mentions -n 20\n```\n\n### Engagement\n\n```bash\n# Like \u002F unlike\nxurl like 1234567890\nxurl unlike 1234567890\n\n# Repost \u002F undo\nxurl repost 1234567890\nxurl unrepost 1234567890\n\n# Bookmark \u002F remove\nxurl bookmark 1234567890\nxurl unbookmark 1234567890\n\n# List your bookmarks \u002F likes\nxurl bookmarks -n 20\nxurl likes -n 20\n```\n\n### Social Graph\n\n```bash\n# Follow \u002F unfollow\nxurl follow @XDevelopers\nxurl unfollow @XDevelopers\n\n# List who you follow \u002F your followers\nxurl following -n 50\nxurl followers -n 50\n\n# List another user's following\u002Ffollowers\nxurl following --of elonmusk -n 20\nxurl followers --of elonmusk -n 20\n\n# Block \u002F unblock\nxurl block @spammer\nxurl unblock @spammer\n\n# Mute \u002F unmute\nxurl mute @annoying\nxurl unmute @annoying\n```\n\n### Direct Messages\n\n```bash\n# Send a DM\nxurl dm @someuser \"Hey, saw your post!\"\n\n# List recent DM events\nxurl dms\nxurl dms -n 25\n```\n\n### Media Upload\n\n```bash\n# Upload a file (auto‑detects type for images\u002Fvideos)\nxurl media upload photo.jpg\nxurl media upload video.mp4\n\n# Specify type and category explicitly\nxurl media upload --media-type image\u002Fjpeg --category tweet_image photo.jpg\n\n# Check processing status (videos need server‑side processing)\nxurl media status MEDIA_ID\nxurl media status --wait MEDIA_ID    # poll until done\n\n# Full workflow: upload then post\nxurl media upload meme.png           # response includes media id\nxurl post \"lol\" --media-id MEDIA_ID\n```\n\n---\n\n## Global Flags\n\nThese flags work on every command:\n\n| Flag         | Short | Description                                                        |\n| ------------ | ----- | ------------------------------------------------------------------ |\n| `--app`      |       | Use a specific registered app for this request (overrides default) |\n| `--auth`     |       | Force auth type: `oauth1`, `oauth2`, or `app`                      |\n| `--username` | `-u`  | Which OAuth2 account to use (if you have multiple)                 |\n| `--verbose`  | `-v`  | Forbidden in agent\u002FLLM sessions (can leak auth headers\u002Ftokens)     |\n| `--trace`    | `-t`  | Add `X-B3-Flags: 1` trace header                                   |\n\n---\n\n## Raw API Access\n\nThe shortcut commands cover the most common operations. For anything else, use xurl's raw curl‑style mode — it works with **any** X API v2 endpoint:\n\n```bash\n# GET request (default)\nxurl \u002F2\u002Fusers\u002Fme\n\n# POST with JSON body\nxurl -X POST \u002F2\u002Ftweets -d '{\"text\":\"Hello world!\"}'\n\n# PUT, PATCH, DELETE\nxurl -X DELETE \u002F2\u002Ftweets\u002F1234567890\n\n# Custom headers\nxurl -H \"Content-Type: application\u002Fjson\" \u002F2\u002Fsome\u002Fendpoint\n\n# Force streaming mode\nxurl -s \u002F2\u002Ftweets\u002Fsearch\u002Fstream\n\n# Full URLs also work\nxurl https:\u002F\u002Fapi.x.com\u002F2\u002Fusers\u002Fme\n```\n\n---\n\n## Streaming\n\nStreaming endpoints are auto‑detected. Known streaming endpoints include:\n\n- `\u002F2\u002Ftweets\u002Fsearch\u002Fstream`\n- `\u002F2\u002Ftweets\u002Fsample\u002Fstream`\n- `\u002F2\u002Ftweets\u002Fsample10\u002Fstream`\n\nYou can force streaming on any endpoint with `-s`:\n\n```bash\nxurl -s \u002F2\u002Fsome\u002Fendpoint\n```\n\n---\n\n## Output Format\n\nAll commands return **JSON** to stdout, pretty‑printed with syntax highlighting. The output structure matches the X API v2 response format. A typical response looks like:\n\n```json\n{\n  \"data\": {\n    \"id\": \"1234567890\",\n    \"text\": \"Hello world!\"\n  }\n}\n```\n\nErrors are also returned as JSON:\n\n```json\n{\n  \"errors\": [\n    {\n      \"message\": \"Not authorized\",\n      \"code\": 403\n    }\n  ]\n}\n```\n\n---\n\n## Common Workflows\n\n### Post with an image\n\n```bash\n# 1. Upload the image\nxurl media upload photo.jpg\n# 2. Copy the media_id from the response, then post\nxurl post \"Check out this photo!\" --media-id MEDIA_ID\n```\n\n### Reply to a conversation\n\n```bash\n# 1. Read the post to understand context\nxurl read https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890\n# 2. Reply\nxurl reply 1234567890 \"Here are my thoughts...\"\n```\n\n### Search and engage\n\n```bash\n# 1. Search for relevant posts\nxurl search \"topic of interest\" -n 10\n# 2. Like an interesting one\nxurl like POST_ID_FROM_RESULTS\n# 3. Reply to it\nxurl reply POST_ID_FROM_RESULTS \"Great point!\"\n```\n\n### Check your activity\n\n```bash\n# See who you are\nxurl whoami\n# Check your mentions\nxurl mentions -n 20\n# Check your timeline\nxurl timeline -n 20\n```\n\n### Set up multiple apps\n\n```bash\n# App credentials must already be configured manually outside agent\u002FLLM context.\n# Authenticate users on each pre-configured app\nxurl auth default prod\nxurl auth oauth2                       # authenticates on prod app\n\nxurl auth default staging\nxurl auth oauth2                       # authenticates on staging app\n\n# Switch between them\nxurl auth default prod alice           # prod app, alice user\nxurl --app staging \u002F2\u002Fusers\u002Fme         # one-off request against staging\n```\n\n---\n\n## Error Handling\n\n- Non‑zero exit code on any error.\n- API errors are printed as JSON to stdout (so you can still parse them).\n- Auth errors suggest re‑running `xurl auth oauth2` or checking your tokens.\n- If a command requires your user ID (like, repost, bookmark, follow, etc.), xurl will automatically fetch it via `\u002F2\u002Fusers\u002Fme`. If that fails, you'll see an auth error.\n\n---\n\n## Notes\n\n- **Rate limits:** The X API enforces rate limits per endpoint. If you get a 429 error, wait and retry. Write endpoints (post, reply, like, repost) have stricter limits than read endpoints.\n- **Scopes:** OAuth 2.0 tokens are requested with broad scopes. If you get a 403 on a specific action, your token may lack the required scope — re‑run `xurl auth oauth2` to get a fresh token.\n- **Token refresh:** OAuth 2.0 tokens auto‑refresh when expired. No manual intervention needed.\n- **Multiple apps:** Each app has its own isolated credentials and tokens. Configure credentials manually outside agent\u002FLLM context, then switch with `xurl auth default` or `--app`.\n- **Multiple accounts:** You can authenticate multiple OAuth 2.0 accounts per app and switch between them with `--username` \u002F `-u` or set a default with `xurl auth default APP USER`.\n- **Default user:** When no `-u` flag is given, xurl uses the default user for the active app (set via `xurl auth default`). If no default user is set, it uses the first available token.\n- **Token storage:** `~\u002F.xurl` is YAML. Each app stores its own credentials and tokens. Never read or send this file to LLM context.\n",{"name":5,"metadata":24,"description":7},{"understudy":25},{"emoji":26,"install":27,"requires":38},"𝕏",[28,33],{"id":29,"bins":30,"kind":29,"label":31,"formula":32},"brew",[5],"Install xurl (brew)","xdevplatform\u002Ftap\u002Fxurl",{"id":34,"bins":35,"kind":34,"label":36,"package":37},"npm",[5],"Install xurl (npm)","@xdevplatform\u002Fxurl",{"bins":39},[5],"main","d69096e239f2a89aabc2cd078c47664a9d3b1e11","05-技能与代理开发\u002Fxurl",3,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts","https:\u002F\u002Fgithub.com\u002Flza6","个人vx：Tf00798\r\n个人✈：@TFGY999","2026-10-08 14:29:22",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add lza6\u002FArmor-piercing-system-prompts --skill xurl",{"tool":54,"command":55},"bunx","bunx skills add lza6\u002FArmor-piercing-system-prompts --skill xurl",{"tool":57,"command":58},"pnpm","pnpm dlx skills add lza6\u002FArmor-piercing-system-prompts --skill xurl","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F05-技能与代理开发\u002Fxurl\u002FSKILL.md",true,[],[63,70,75,82,89,96],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7FFG485KY83TD6HSC4YPCMC","obsidian-clipper-template-creator","Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator\u002FSKILL.md",[],[],{"skillNo":71,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M7FFG0T6AZ0STEJPSB3CX84K","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator-antigravity-awesome-skills-main\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7FFFY0QEM14SKWPDYGMXM2P","python-api","Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP\u002FmAP semantics, and source-style import diagnostics.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Fpython-api\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7FFFVZQZ2GJ0C0TGP7JHD20","file-evaluation","Folder-based PASCAL VOC AP\u002FmAP evaluation from ground-truth and detection text files.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Ffile-evaluation\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7FFFSFNYSE77SJ6PE1CK2DA","object-detection-metrics","Guides legacy Object-Detection-Metrics PASCAL VOC AP\u002FmAP evaluation from detection text folders and direct Python API classes.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7FFFP0GCK1RVXBCPQ8APBMT","nx-workspace-patterns","Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fnx-workspace-patterns\u002FSKILL.md",[],[]]