Fediverse CLI — celestial messenger for the federation.
Project description
taibai
Fediverse CLI tool — 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 (龙威).
Built on longwei.
Documentation: https://marvinsmastodontools.codeberg.page/taibai/latest/
Install
uv tool install taibai
Usage
taibai init # authenticate with a Fediverse instance
taibai init --instance URL --token TOKEN # headless / non-interactive setup
taibai whoami # display current account
taibai token # print stored access token (for CI/CD secrets)
taibai post "Hello, world!" # publish a status
taibai post "Reply!" --reply-to ID # reply to a status (chain with --json | jq for threads)
taibai notifications # show new notifications
taibai timeline # home timeline (public/tag/list also supported)
taibai view 123456789012345678 # view a status or thread (--context for full thread)
taibai fav ID # favourite a status
taibai boost ID # boost a status
taibai bookmark ID # bookmark a status
taibai pin ID # pin a status to your profile
taibai delete ID # delete a status
taibai edit ID "New text." # edit a status
taibai bookmarks # list your bookmarks
taibai favourites # list your favourites
taibai follow user@instance.social # follow an account
taibai unfollow user@instance.social
taibai mute user@instance.social # mute (optional --duration SECS, --no-notifications)
taibai unmute user@instance.social
taibai block user@instance.social
taibai unblock user@instance.social
taibai profile user@instance.social # view profile + recent posts
taibai search "climate change" # search statuses, accounts, and hashtags
taibai search python --type accounts --resolve
taibai thread my-thread.md # post a thread from a file
taibai thread-download URL # download a thread to stdout (--format thread|json|markdown)
taibai completions bash # print bash completion script (eval or source)
All data-returning commands accept --json to dump output as JSON instead of a Rich table or panel.
Use --profile / -p (or TAIBAI_PROFILE env var) to manage multiple accounts.
License
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file taibai-0.10.2.tar.gz.
File metadata
- Download URL: taibai-0.10.2.tar.gz
- Upload date:
- Size: 26.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
19de53c93bd16bfaae77c9cd35070655c87ae30d91ad532a647d92a5d575441a
|
|
| MD5 |
84d1fe013ee9af2acdac83eb9a45ee58
|
|
| BLAKE2b-256 |
b0be6dfa896a021fb9594e957ef107106fbb676d46a15e3fe604f6d34a86ac00
|
File details
Details for the file taibai-0.10.2-py3-none-any.whl.
File metadata
- Download URL: taibai-0.10.2-py3-none-any.whl
- Upload date:
- Size: 42.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
832bd094300bddeaae085f4ffc5b19fc200deae1a9dc4baf57a2c553c36124a9
|
|
| MD5 |
7a425941bad6a3f2a75d8a64be5003b8
|
|
| BLAKE2b-256 |
87ccbbbd26abc41c40892e3295cf605c0db117819a3cf7c8f046d45211c08749
|
