Metadata-Version: 2.3
Name: taibai
Version: 0.2.0
Summary: Fediverse CLI — celestial messenger for the federation.
Author: marvin8
Author-email: marvin8 <marvin8@tuta.io>
License: AGPL-3.0-or-later
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications
Classifier: Topic :: Internet
Requires-Dist: cyclopts~=4.10.2
Requires-Dist: httpx[http2,zstd]~=0.28.1
Requires-Dist: keyring~=25.7.0
Requires-Dist: longwei~=1.4.0
Requires-Dist: platformdirs~=4.9.6
Requires-Dist: rich~=15.0.0
Requires-Python: >=3.11, <3.15
Project-URL: Source, https://codeberg.org/MarvinsMastodonTools/taibai
Project-URL: Issues, https://codeberg.org/MarvinsMastodonTools/taibai/issues
Description-Content-Type: text/markdown

# 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](https://codeberg.org/MarvinsMastodonTools/longwei) (龙威).

Built on [longwei](https://codeberg.org/MarvinsMastodonTools/longwei).

## Install

```sh
uv tool install taibai
```

## Usage

```sh
taibai init                     # authenticate with a Fediverse instance
taibai whoami                   # display current account
taibai post "Hello, world!"     # publish a status
taibai notifications            # show new notifications
```

Use `--profile` / `-p` (or `TAIBAI_PROFILE` env var) to manage multiple accounts.

## License

[AGPL-3.0-or-later](LICENSE.md)
