Skip to content

Notifications

Viewing notifications

taibai notifications

By default only unread notifications are shown — those that arrived since the last time you ran the command. A rich table is printed with the notification type, the account that triggered it, a short preview of the associated post (where applicable), and a timestamp:

 Type           From                          Preview                           Time
 mention        @friend@example.com           Hey, did you see this?            2026-04-18 09:12
 favourite      @reader@fosstodon.org                                           2026-04-18 08:44
 reblog         @booster@hachyderm.io         My earlier post text…             2026-04-17 22:03

After the table is displayed, taibai records the ID of the newest notification. The next run will only fetch notifications newer than that ID.

Showing all notifications

Pass --all to ignore the read cursor and fetch the full notification list up to the server's default limit:

taibai notifications --all

Note — --all does not reset the read cursor

Running with --all still updates last_seen_notification_id to the newest notification shown, so subsequent runs (without --all) will continue from that point.

Limiting results

Use --limit / -n to cap how many notifications are returned:

taibai notifications --limit 5
taibai notifications --all --limit 50

When omitted, the server's default applies (typically 20).

JSON output

Pass --json to dump all fetched notifications as a JSON array instead of the table. Only fields that have a value are included. Useful for scripting or piping to jq:

taibai notifications --json
taibai notifications --all --json | jq '.[0].type'

Note — --json still updates the read cursor

The last-seen ID is updated normally even in JSON mode, so subsequent runs without --json will continue from the most recent notification shown.

Read tracking

taibai stores a last_seen_notification_id per profile in ~/.config/taibai/config.json. Each time taibai notifications runs successfully and returns at least one notification, the ID of the most recent notification is saved. The next invocation passes this ID to the server as since_id, so only new notifications are returned.

To reset the cursor manually — for example, to re-read everything — use --all, or delete the last_seen_notification_id field from the relevant profile entry in config.json.

Options reference

Option Short Env Default Description
--all — — off Show all notifications, not just new ones
--limit -n — server default Maximum number of notifications to fetch
--json — — off Dump notifications as JSON instead of a table
--profile -p TAIBAI_PROFILE default Profile to use