Conversations¶

Manage your direct-message threads on the Fediverse. The conversations command lists your DM conversations and lets you mark them as read or delete them.

Listing conversations¶

taibai conversations

Fetches your direct-message conversations and displays them in a Rich table:

Column	Description
ID	The conversation ID (use this with `read` and `delete`)
Unread	✓ if the conversation has unread messages, `-` if it has been read
Participants	`@handle` for each account in the conversation
Last message	A preview of the most recent message (HTML stripped, truncated to 80 characters)

Use --limit / -n to control how many conversations are returned (default: 20):

taibai conversations --limit 10

Marking a conversation as read¶

taibai conversations read CONVERSATION_ID

Marks the specified conversation as read and prints a confirmation. The conversation ID is shown in the ID column of taibai conversations.

taibai conversations read 12345

Deleting a conversation¶

taibai conversations delete CONVERSATION_ID

Permanently removes the conversation from your account and prints a confirmation.

taibai conversations delete 12345

Warning

Deletion is permanent. The conversation will be removed from your account; other participants are not notified.

JSON output¶

Pass --json to the bare conversations command to dump the raw conversation objects as a JSON array instead of a table. Only fields with values are included.

taibai conversations --json
taibai conversations --json | jq '.[].id'
taibai conversations --json | jq '[.[] | select(.unread == true) | .id]'

Options reference¶

`taibai conversations`¶

Option	Short	Env	Default	Description
`--limit`	`-n`	—	`20`	Maximum number of conversations to fetch
`--json`	—	—	off	Dump conversations as JSON instead of a table
`--profile`	`-p`	`TAIBAI_PROFILE`	`default`	Profile to use

`taibai conversations read CONVERSATION_ID`¶

Option	Short	Env	Default	Description
`--profile`	`-p`	`TAIBAI_PROFILE`	`default`	Profile to use

`taibai conversations delete CONVERSATION_ID`¶

Option	Short	Env	Default	Description
`--profile`	`-p`	`TAIBAI_PROFILE`	`default`	Profile to use