twitterlisted
Install: claude install-skill vanducng/skills
# twitter
Personal CLI for reading and writing on X/Twitter. Wraps a patched twikit primary path with an agent-browser fallback router for resilience.
## Quick start
```bash
twitter import-from-dia # one-time: pull cookies from Dia (macOS)
twitter doctor # confirm setup
twitter fetch https://x.com/jack/status/2049336710572728783
twitter post "hello from twitter skill"
```
## Verbs
| Verb | Example |
|---|---|
| `import-from-dia` | `twitter import-from-dia [--profile NAME] [--dry-run]` |
| `login` | `twitter login` (gopass-backed; needs `credentials` + `totp` entries) |
| `doctor` | `twitter doctor [--offline]` |
| `fetch` | `twitter fetch https://x.com/<u>/status/<id>` · `twitter fetch @jack --count 10` · `twitter fetch search:claude --count 5` |
| `timeline` | `twitter timeline latest --count 20` · `twitter timeline home` · `twitter timeline user:@jack` |
| `post` | `twitter post "text" [--media a.jpg b.jpg] [--long] [--community ID] [--share-with-followers]` |
| `reply` | `twitter reply <url\|id> "text" [--media path...]` |
| `thread` | `twitter thread "a" "b" "c"` |
| `delete` | `twitter delete <url\|id>` |
Global flag `--use-browser` forces the agent-browser fallback for `fetch` / `post`.
## Failure modes
See [`references/failure-modes.md`](references/failure-modes.md) for the runbook covering Error 226, 401, 429, account-lock, transaction-init drift, and selector fragility. `twitter doctor` produces class-specific remediation hints inline.