CLI
CLI Commands
Complete reference for all Chirpie CLI commands.
Posts
Create a Post
chirpie post "Your post text here"| Flag | Description |
|---|---|
-a, --account <id> | Account ID (auto-selects if you have one account) |
-m, --media <urls...> | Up to 4 image/video URLs (JPEG, PNG, WebP, GIF up to 5MB; MP4/MOV up to 512MB) |
-s, --schedule <datetime> | Schedule for a future time (ISO 8601) |
--json | Output as JSON |
# Schedule a post
chirpie post "Launching tomorrow!" -s "2026-04-01T14:00:00Z"
# Post with an image
chirpie post "Check this out!" -m https://example.com/screenshot.png
# Post to a specific account
chirpie post "Hello!" -a 550e8400-e29b-41d4-a716-446655440000Create a Thread
chirpie thread "First post" "Second post" "Third post"| Flag | Description |
|---|---|
-a, --account <id> | Account ID |
-s, --schedule <datetime> | Schedule the thread |
--json | Output as JSON |
Minimum 2 posts, maximum 25.
List Posts
chirpie posts| Flag | Description |
|---|---|
--status <status> | Filter by status |
--account <id> | Filter by account |
--limit <n> | Number of results (default 20) |
--json | Output as JSON |
Get Post Details
chirpie posts get <post_id>Delete a Post
chirpie posts delete <post_id>Accounts
List Accounts
chirpie accountsShows a table of connected X accounts with username, display name, and active status.
Connect an Account
chirpie accounts connectPrints an authorization URL. Open it in your browser to complete the OAuth flow.
API Keys
List Keys
chirpie keysCreate a Key
chirpie keys create
chirpie keys create -n "My Bot Key"| Flag | Description |
|---|---|
-n, --name <name> | Key name |
Revoke a Key
chirpie keys revoke <key_id>Analytics
Get Post Metrics
chirpie analytics <post_id>Displays impressions, likes, retweets, replies, quotes, bookmarks, and clicks.