Skip to main content

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 whoami                        # display current account
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

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

AGPL-3.0-or-later

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

taibai-0.5.0.tar.gz (19.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

taibai-0.5.0-py3-none-any.whl (31.2 kB view details)

Uploaded Python 3

File details

Details for the file taibai-0.5.0.tar.gz.

File metadata

  • Download URL: taibai-0.5.0.tar.gz
  • Upload date:
  • Size: 19.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for taibai-0.5.0.tar.gz
Algorithm Hash digest
SHA256 6633d7a977cbcbaa5dbc1573ffdbdce344e828a206df5cb3fcb115791d27c6ee
MD5 38cfd2c8b68e4e5ab0ea7c09e0388023
BLAKE2b-256 601afe38931a7aff7f9393ab1515ec6e4ca0ead00f32201bce9eeb7467fdd3a2

See more details on using hashes here.

File details

Details for the file taibai-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: taibai-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 31.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for taibai-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bc660f6a4c1cadd3b241a012c4000f76359717fd42d3ef0c597e0bf62b908bed
MD5 281a85ff1bbcfd2e7d8eaad990002e61
BLAKE2b-256 407b667f9415589e6721f9c681cd6579ef7f20430ef4af7cb92afac1f85031e4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page