Skip to content

Social graph

These commands manage your relationships with other accounts: following, muting, and blocking. All commands accept a user@host handle or a bare numeric account ID.


Account input

Every command takes an ACCOUNT argument. taibai accepts:

  • A full handle: user@mastodon.social
  • A handle with a leading @: @user@mastodon.social
  • A bare numeric account ID: 109031952222346765

Follow / Unfollow

Follow an account:

taibai follow user@mastodon.social

Unfollow:

taibai unfollow user@mastodon.social

Both commands print a confirmation line and return the updated relationship. Use --json to dump the relationship object instead:

taibai follow user@mastodon.social --json

Mute / Unmute

Mute an account (hides their posts from your timelines and, by default, their notifications):

taibai mute user@mastodon.social

Mute for a fixed duration (seconds):

taibai mute user@mastodon.social --duration 86400

Mute posts only, keep notifications:

taibai mute user@mastodon.social --no-notifications

Unmute:

taibai unmute user@mastodon.social

Block / Unblock

Block an account (prevents them from seeing or interacting with your posts):

taibai block user@mastodon.social

Unblock:

taibai unblock user@mastodon.social

View a profile

Display a remote account's profile and their most recent posts:

taibai profile user@mastodon.social
taibai profile user@mastodon.social --limit 10

--limit controls how many recent posts are shown (default: 20).

Use --json to dump the account info and posts as a JSON object:

taibai profile user@mastodon.social --json | jq '.account.followers_count'

Options reference

Short-action commands (follow, unfollow, block, unblock, unmute):

Option Short Default Description
ACCOUNT Handle (user@host) or numeric ID
--json off Dump the relationship as JSON
--profile -p default Profile name (TAIBAI_PROFILE env var)

mute additionally accepts:

Option Default Description
--duration SECS indefinite Mute duration in seconds
--no-notifications off Keep notifications, only mute posts

profile additionally accepts:

Option Short Default Description
--limit -n 20 Maximum number of recent posts to show
--json off Dump account + posts as JSON