Acting

Compose & Reply

GitHub Edit page

Compose & Reply

Three verbs cover everything you can publish: post, reply, and dm.

1 compose post 0
1 compose reply tweet_004 0
1 compose dm dm_003 0

All three use the active live transport (auto by default — xurl first, bird second). They never touch SQLite when the live call fails, so a failed publish does not leave a half-state row behind.

#compose post

Post a new tweet on the active account.

1 compose post 0
2 compose post 1 acct_primary 0

Flags:

  • --account <id>
  • --reply-to <tweet-id> — equivalent to compose reply
  • --quote <tweet-id> — quote-tweet
  • --media <path> — attach a local file (planned)
  • --dry-run — render the payload, do not publish

#compose reply

Reply to an existing tweet by ID.

1 compose reply 1891234567890 0
1 compose reply tweet_004 0

The <tweet-id> argument accepts:

  • canonical numeric Twitter IDs (e.g. 1891234567890)
  • local short IDs from search results (e.g. tweet_004)
  • canonical Twitter URLs (e.g. https://x.com/user/status/1891...)

#compose dm

Reply within an existing DM conversation by conversation ID.

1 compose dm dm_003 0
2 compose dm dm_004 1 acct_primary 0

compose dm resolves the conversation, picks the right transport (bird is preferred for DM writes because OAuth2 DM scopes are flaky), and merges the sent message back into the local DM tables.

#Disabling live writes

Set BIRDCLAW_DISABLE_LIVE_WRITES=1 to make every compose verb a dry-run regardless of flags. CI and the test suite rely on this — see Configuration.

0 BIRDCLAW_DISABLE_LIVE_WRITES=1
1 compose post 0

The command still validates the payload and prints what would have been sent.

#Web UI

The web app's Home, Mentions, and DMs lanes all share the same compose backend. Drafts are stored locally in SQLite while you type, so closing a tab does not lose work.

#Exit codes

  • 0 — published
  • 2 — invalid usage (missing tweet ID, empty body)
  • 3 — auth unavailable for the active account
  • 4 — transport unavailable (xurl and bird both failed)

#See also

  • Configuration — transport precedence and BIRDCLAW_DISABLE_LIVE_WRITES
  • Mentions — pull a unreplied queue, then reply
  • DMs — DM triage flow