Skip to content

Lists

Manage your Mastodon lists — create, delete, and add or remove accounts.


Show all lists

taibai lists

Displays a table of your lists with their IDs, titles, and reply policies.


Create a list

taibai lists create "My Python Friends"

With a reply policy:

taibai lists create "News" --replies-policy none

Valid values for --replies-policy:

Value Behaviour
followed Show replies to accounts you follow
list Show replies to other accounts in the list
none Show no replies

The server default when omitted is list.


Delete a list

taibai lists delete LIST_ID

Add accounts to a list

taibai lists add LIST_ID user@instance.social
taibai lists add LIST_ID user@instance.social other@example.com

Accepts handles (user@host) or numeric account IDs. Accounts must already be followed by you.


Remove accounts from a list

taibai lists remove LIST_ID user@instance.social

JSON output

The bare lists command supports --json to dump all lists as a JSON array:

taibai lists --json
taibai lists --json | jq '.[].title'

Profile selection

All subcommands accept --profile/-p (or the TAIBAI_PROFILE environment variable):

taibai lists --profile work
taibai lists create "Work Contacts" --profile work