用途：xurl 是 X API 的命令行工具，既提供人类与智能体友好的快捷命令，也支持 curl 风格的原始 v2 端点调用，适合在命令行中完成 X 平台的读写与互动操作。
主要能力：发帖、回复、引用、删除、读取帖子；搜索、主页时间线与提及；点赞、转推、书签；关注、取关、拉黑、静音；发送私信与查看私信事件；上传媒体并查询处理状态；查看自身与任意用户信息。所有命令输出 JSON 到 stdout，结构与 X API v2 响应一致，错误同样以 JSON 返回，出错时退出码非零。
安装：brew install --cask xdevplatform/tap/xurl；npm install -g @xdevplatform/xurl；curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash；go install github.com/xdevplatform/xurl@latest。
用法：使用前需认证，先运行 xurl auth status 检查。凭据需由用户在自己机器上手动填入 ~/.xurl，注册应用后在智能体会话之外运行 xurl auth oauth2。可用 xurl auth default APP USER 设置默认应用与账号，或用 --app 单次覆盖。常见示例：xurl post "Hello world!"、xurl reply POST_ID "Nice post!"、xurl search "QUERY" -n 10、xurl dm @handle "message"、xurl media upload path/to/file.mp4、xurl /2/users/me。帖子标识可传 ID 或完整 URL，用户名开头 @ 可省略。
安全限制：严禁在智能体会话中读取、打印、上传或发送 ~/.xurl；不要要求用户粘贴凭据；不要使用 --verbose/-v，也不要在命令中使用 --bearer-token、--consumer-key、--consumer-secret、--access-token、--token-secret、--client-id、--client-secret 等敏感参数；认证与应用凭据配置必须由用户在会话外手动完成。
其它限制：受 X API 速率限制，遇到 429 需等待重试，写操作限制更严格；令牌作用域不足时某些操作会返回 403，需重新运行 xurl auth oauth2。OAuth 2.0 令牌过期会自动刷新。每个应用凭据与令牌相互隔离。具体收费、价格与额度资料中暂未提供。