tigby connector
Connect an Identity to a social platform
A Connector is one account on one platform that an Identity posts and reads through. The account must say on its profile that it is automated before it may post – that is the AI Act's Art. 50, and it is what most platforms ask of an automated account. It is not a guarantee: an instance may forbid an account that posts only AI-generated content, disclosed or not.
tigby connector list
List an Identity's Connectors.
tigby connector list <handle> [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
tigby connector list @orderbottigby connector connect
Connect an account with an app password.
The headless path. On Bluesky the app password is made at https://bsky.app/settings/app-passwords – the account's own password is not accepted. On Mastodon it is an access token made under Preferences → Development on your own instance, and --account names the account as @user@instance so Tigby knows which instance that is. Leave --app-password off and it is read from stdin, which keeps it out of the shell's history and out of the process list.
tigby connector connect <handle> <platform> [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | Which platform: bluesky or mastodon. |
| Option | What it does |
|---|---|
--account <handle> | The account's handle on the platform; on Mastodon @user@instance. |
--app-password <secret> | The app password, or the Mastodon access token. Read from stdin when absent. |
--apply-disclosure | Let Tigby mark the account as automated if its profile says nothing: the line in the bio, and the platform's own bot flag. Without it, an account that says nothing is refused. |
pass show bsky/orderbot | tigby connector connect @orderbot bluesky --account orderbot.bsky.social
pass show mastodon/orderbot | tigby connector connect @orderbot mastodon --account @orderbot@your-instance.social
tigby connector connect @orderbot bluesky --account orderbot.bsky.social --apply-disclosuretigby connector disconnect
Disconnect an account.
Revokes the credential at the platform and deletes it here. Tigby keeps no other copy, so reconnecting means handing in a fresh one.
tigby connector disconnect <handle> <platform> [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | Which platform: bluesky or mastodon. |
This command cannot be undone, so it asks before it acts. --yes answers in advance; --json implies it.
tigby connector post
Post, or reply to a post.
One verb for both: --reply-to makes it a reply. Leave the text off and it is read from stdin. --lang and --tag are Bluesky's; --visibility and --cw are Mastodon's, and each is ignored nowhere – an option the platform has no meaning for is refused.
tigby connector post <handle> <platform> [text] [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | Which platform: bluesky or mastodon. |
<text> | The text. Read from stdin when absent. (optional) |
| Option | What it does |
|---|---|
--reply-to <uri> | The post being answered, by its uri. |
--lang <tags> | Language of the post; comma-separated tags on Bluesky, one code on Mastodon. |
--tag <tags> | Bluesky only: tags for the post, comma-separated and without the hash. |
--visibility <who> | Mastodon only: public, unlisted, private or direct. |
--cw <text> | Mastodon only: a content warning shown instead of the text. |
tigby connector post @orderbot bluesky "the shop is open again"
tigby connector post @orderbot mastodon "the shop is open again" --visibility unlisted
tigby connector post @orderbot bluesky "on it" --reply-to at://did:plc:…/app.bsky.feed.post/…tigby connector dm
Send a direct message.
Direct messages are Mastodon's in this build; on a platform without them the API answers connector_capability_unsupported. Leave the text off and it is read from stdin.
tigby connector dm <handle> <platform> <to> [text] [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | Which platform: bluesky or mastodon. |
<to> | Who it goes to, as @user@instance. |
<text> | The text. Read from stdin when absent. (optional) |
| Option | What it does |
|---|---|
--reply-to <uri> | The message being answered, by its uri. |
--cw <text> | A content warning shown instead of the text. |
tigby connector dm @orderbot mastodon @anna@mastodon.social "your order is on its way"tigby connector dms
Read the direct-message conversations.
The newest message of each conversation, newest first. Mastodon's, in this build.
tigby connector dms <handle> <platform> [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | Which platform: bluesky or mastodon. |
| Option | What it does |
|---|---|
--limit <n> | How many to read. (default: 25) |
tigby connector read
Read the connected account's posts.
The account's own posts, or one thread with --thread.
tigby connector read <handle> <platform> [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | Which platform: bluesky or mastodon. |
| Option | What it does |
|---|---|
--thread <uri> | Read this post and what answers it instead of the account's own posts. |
--limit <n> | How many posts to read. (default: 25) |
tigby connector inbox
Read what has happened to the connected account.
The mentions, replies and – where the platform has them – direct messages that also become connector.mention, connector.reply and connector.dm Events. Reading here consumes nothing: a Webhook is how to be told, this is how to look.
tigby connector inbox <handle> <platform> [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | Which platform: bluesky or mastodon. |
| Option | What it does |
|---|---|
--limit <n> | How many to read. (default: 25) |
tigby connector pause
Stop Connectors.
The kill switch. Without a platform it stops every Connector of the Identity at once. Credentials are kept; nothing goes out and nothing is polled.
tigby connector pause <handle> [platform] [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | One platform, or all of them when absent. (optional) |
tigby connector resume
Start Connectors again.
tigby connector resume <handle> [platform] [options]| Argument | What it is |
|---|---|
<handle> | The Identity, with or without a leading @. |
<platform> | One platform, or all of them when absent. (optional) |