Skip to content

taibai

Fediverse CLI — celestial messenger for the federation.

Taibai (太白金星, Tàibái Jīnxīng — "Gold Star of Venus") is the celestial herald in Chinese mythology, tasked with carrying messages between heaven and earth. The name fits a tool that sends and receives communications across a federated network, and continues the Chinese mythology theme of its companion library longwei (龙威).

Quick start

uv tool install taibai
taibai init
taibai post "Hello, fediverse!"

Commands

Command Description
init Authenticate with a Fediverse instance
whoami Display the current account
post Publish a status (supports --reply-to for threads)
notifications Show new notifications
timeline Fetch and display a timeline (home, public, tag, or list)
view Display a single status or thread
fav / unfav Favourite or un-favourite a status
boost / unboost Boost or un-boost a status
bookmark / unbookmark Bookmark or un-bookmark a status
pin / unpin Pin or unpin a status on your profile
delete Delete one of your statuses
bookmarks List your bookmarked statuses
favourites List your favourited statuses
edit Edit the text of one of your statuses
follow / unfollow Follow or unfollow an account
mute / unmute Mute or unmute an account
block / unblock Block or unblock an account
profile View a remote account profile and recent posts
search Search for statuses, accounts, and hashtags

Project information