xurllisted
Install: claude install-skill transitive-bullshit/skills
# xurl
Use `xurl` for X API work. Shortcut commands return JSON; raw mode works for any v2 endpoint.
## Auth
- `~/.xurl` holds tokens; check auth with `xurl auth status` instead of reading it.
- Pass secrets to auth commands through the prompt, not inline, so they stay out of shell history.
- `--verbose` prints auth headers into tool output.
## Common shortcuts
```bash
xurl post "Hello world!"
xurl reply POST_ID "Nice."
xurl quote POST_ID "My take"
xurl delete POST_ID
xurl read POST_ID
xurl search "query" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "message"
xurl dms -n 10
```
`POST_ID` can be a full `https://x.com/<user>/status/<id>` URL.
## Media
```bash
xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID
```
Videos may need processing; poll `media status`.
## Auth/app management
```bash
xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME
```
Per request:
```bash
xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me
```
## Raw API
```bash
xurl /2/users/me
xurl -X POST /2/tweets -d '{