Metadata-Version: 2.3
Name: taibai
Version: 0.4.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: Documentation, https://marvinsmastodontools.codeberg.page/taibai/latest/
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).

**Documentation:** https://marvinsmastodontools.codeberg.page/taibai/latest/

## 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
taibai timeline                      # home timeline (public/tag/list also supported)
taibai view 123456789012345678        # view a status or thread (--context for full thread)
```

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](LICENSE.md)
