# Send Tweet Cli to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tweet-cli",
    "name": "Tweet Cli",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/0xmythril/tweet-cli",
    "canonicalUrl": "https://clawhub.ai/0xmythril/tweet-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/tweet-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tweet-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "tweet-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T06:28:54.899Z",
      "expiresAt": "2026-05-17T06:28:54.899Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tweet-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tweet-cli",
        "contentDisposition": "attachment; filename=\"tweet-cli-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "tweet-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/tweet-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tweet-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/tweet-cli",
    "agentUrl": "https://openagent3.xyz/skills/tweet-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tweet-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tweet-cli/agent.md"
  }
}
```
## Documentation

### tweet-cli

Post to X/Twitter using the official API v2. This tool uses API credits (limited to 1,500 posts/month on the Free tier), so only use it when the user explicitly asks you to post, or during scheduled cron tasks. Do not speculatively draft and post tweets.

For reading tweets, searching, and browsing timelines, use bird instead (no credit cost).

### Setup

Install (pinned to release tag):

npm install -g github:0xmythril/tweet-cli#v1.0.0

Get API keys from https://developer.x.com/en/portal/dashboard (Free tier works)
Configure credentials (file is created with restricted permissions):

mkdir -p ~/.config/tweet-cli
touch ~/.config/tweet-cli/.env
chmod 600 ~/.config/tweet-cli/.env
cat > ~/.config/tweet-cli/.env << 'EOF'
X_API_KEY=your_consumer_key
X_API_SECRET=your_secret_key
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
EOF

Verify: tweet-cli whoami

### Security

Credentials: Stored in ~/.config/tweet-cli/.env (read by dotenv at runtime). Set chmod 600 to restrict access.
No postinstall scripts: The package has zero install scripts — verify via npm pack --dry-run or inspect package.json.
No telemetry or network calls except to the official X API (api.x.com) when you run a command.
Pinned install: The install command pins to a specific release tag. Audit the source at https://github.com/0xmythril/tweet-cli before installing.
Dependencies: Only 3 runtime deps — twitter-api-v2 (official X API client), commander (CLI parsing), dotenv (env file loading). No transitive dependencies.

### Verify auth

tweet-cli whoami

### Post a tweet

tweet-cli post "Your tweet text here"

### Reply to a tweet

tweet-cli reply <tweet-id-or-url> "Your reply text"
tweet-cli reply https://x.com/user/status/123456 "Your reply text"

### Quote a tweet

tweet-cli quote <tweet-id-or-url> "Your commentary"
tweet-cli quote https://x.com/user/status/123456 "Your commentary"

### Delete a tweet

tweet-cli delete <tweet-id-or-url>

### Important rules

Do NOT post unless the user explicitly asks or a cron job triggers it. Each post uses API credits.
Always confirm with the user before posting, replying, or quoting. Show them the text first.
For reading tweets, searching, or viewing timelines, use bird (not tweet-cli).
tweet-cli accepts both raw tweet IDs and full URLs (x.com or twitter.com).
If you get a 402 CreditsDepleted error, inform the user their monthly credits are exhausted.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 0xmythril
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T06:28:54.899Z
- Expires at: 2026-05-17T06:28:54.899Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/tweet-cli)
- [Send to Agent page](https://openagent3.xyz/skills/tweet-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/tweet-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/tweet-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/tweet-cli)