Bluesky no terminal: que CLI escolher?
Use bsbot para os identificadores Bluesky.bot, goat para operações gerais do AT Protocol e um cliente de publicação para o feed. Cada sessão indica a versão e distingue a ajuda local das leituras públicas.
Por A equipa do Bluesky.bot
- Publicado:
- Atualizado:
- Revisto:
Escolher pela tarefa
Para os identificadores name.bluesky.bot dos seus bots, comece pelo bsbot e pela referência CLI. Para resolver identidades públicas, exportar repositórios, examinar ficheiros CAR, ler o histórico PLC ou migrar contas, considere goat. Para o feed e publicações, considere mattn/bsky ou um SDK do AT Protocol. As finalidades e permissões diferem.
| Ferramenta e versão | Uso adequado | Autenticação e escritas | Instalação e licença | Fonte e revisão |
|---|---|---|---|---|
bsbot 0.1.0 TypeScript / Node.js ≥ 22 Publicado em 12 de nov. de 2026 | Gerir os identificadores Bluesky.bot; consultar nomes e o diretório público. Não publica nem lê o feed. | OAuth no navegador para ações da conta. O seu token gere identificadores e é distinto de uma palavra-passe de aplicação do Bluesky. | npm install --global @blueskydotbot/[email protected]MIT | Fonte versionada Verificado em 16 de nov. de 2026 |
goat 0.2.9 Go Publicado em 6 de nov. de 2026 | Resolver identidades, examinar repositórios e ficheiros CAR, ler o histórico PLC, exportar, administrar ou migrar contas. | Muitas leituras são públicas. As escritas usam uma palavra-passe de aplicação; o cliente documenta o armazenamento local das credenciais. | go install github.com/bluesky-social/[email protected]MIT / Apache-2.0 | Fonte versionada Verificado em 16 de nov. de 2026 |
mattn/bsky 0.0.82 Go Publicado em 19 de ago. de 2026 | Cliente do Bluesky para publicar e ler o feed, com comandos de perfil, seguimento, moderação e outras ações. | A entrada documentada aceita identificador e palavra-passe. Use uma palavra-passe de aplicação; os comandos autenticados podem alterar a conta. | go install github.com/mattn/[email protected]MIT | Fonte versionada Verificado em 16 de nov. de 2026 |
A comparação descreve versões verificadas, não código por publicar. Executámos a ajuda local do bsbot e bsky, uma consulta pública de nome com bsbot e uma resolução pública de DID com goat. Não executámos publicações, migrações ou alterações de identificador autenticadas.
Instalar e verificar a versão
npm install --global @blueskydotbot/[email protected]
bsbot --version
bsbot --helpA versão fixada corresponde à captura. Para uma execução pontual use npx @blueskydotbot/[email protected] --help. Leia as notas antes de escolher uma versão mais recente. Os requisitos documentados são Node.js 22 ou posterior em macOS ou Linux; esta sessão usou Linux e Node.js 24.
bsbot 0.1.0 ·
Comando local; sem ligação a uma conta · Código de saída 0
bsbot --helpbsbot 0.1.0: manage your Bluesky bots and their name.bluesky.bot handles.
Usage: bsbot <command> [options]
Account
login [--no-browser] [--name <label>]
Sign in through the browser (OAuth, no password);
<label> names this machine in your settings
logout Revoke this machine's token and forget it
whoami Show the signed-in account
Handles
check <name> Is <name>.bluesky.bot free to claim?
claim <bot> <name> Claim <name>.bluesky.bot for a bot and switch to it
switch <bot> Ask the bot's server again to use its handle
verify <bot> Check that the bot's handle is live on Bluesky
release <bot> [--yes] Give the handle up (the bot goes back to its old one)
Bots
bots List your bots
directory [--q <text>] [--category <c>] [--verified] [--limit <n>] [--cursor <c>]
Browse the public directory
<bot> is a bot's DID, its handle, its previous handle, or the name of its
.bluesky.bot handle. Add bots from the dashboard: https://bluesky.bot/manage
Options
--json Machine-readable output (never contains the token)
--api-url <url> Another server (or BSBOT_API_URL)
-h, --help This help
-v, --version The version
Começar por uma leitura pública
check consulta a disponibilidade de um nome, sem o reservar. O nome capturado pertence à conta CLI do projeto; a disponibilidade e as sugestões podem mudar.
bsbot 0.1.0 ·
Leitura da API pública do Bluesky.bot · Código de saída 0
bsbot check cli --json{
"name": "cli",
"handle": "cli.bluesky.bot",
"available": false,
"reason": "taken",
"suggestions": [
"cli2",
"cli-24",
"cli3"
]
}
Entrar e gerir o seu bot
Os comandos seguintes são instruções, não sessões autenticadas gravadas. Adicione primeiro o bot no painel. Execute bsbot login, confirme a conta e o nome da máquina no navegador e autorize. Nenhuma palavra-passe do Bluesky passa pelo bsbot. O token é do Bluesky.bot e não permite publicar no Bluesky.
bsbot login
bsbot whoami
bsbot botsEscolha o DID do seu bot e um nome livre. A sintaxe publicada é:
bsbot claim BOT_DID chosen-name
bsbot switch BOT_DID
bsbot verify BOT_DIDSubstitua os parâmetros. claim pede o nome e solicita ao servidor do bot a alteração do identificador; switch repete o pedido. verify verifica se está ativo. Leia o estado antes de repetir: pending pode exigir esperar, enquanto manual requer a sua intervenção. Consulte a verificação.
Doctor e CI: distinguir servidor e CLI publicado
O pacote npm verificado é 0.1.0, mesmo que o repositório descreva trabalho posterior. Não inclui doctor, listing nem suporte para BSBOT_TOKEN. As capturas de comando desconhecido são reais; não mostram diagnósticos ou alterações de ficha bem-sucedidos.
bsbot 0.1.0 ·
Comando local; sem ligação a uma conta · Código de saída 2
bsbot doctor --json{"error":{"code":"usage","message":"Unknown command \"doctor\". See bsbot --help."}}
bsbot 0.1.0 ·
Comando local; sem ligação a uma conta · Código de saída 2
bsbot listing get cli --json{"error":{"code":"usage","message":"Unknown command \"listing\". See bsbot --help."}}
Use o diagnóstico do painel. A referência da API descreve os endpoints autenticados de diagnóstico e ficha, e tokens de implementação limitados às fichas. No CI, siga esse contrato HTTP, guarde o segredo no cofre e limite o token ao bot previsto. Um exemplo HTTP não demonstra suporte de um comando bsbot listing set por publicar. A referência CLI mantém os detalhes de compatibilidade.
Ler AT Protocol com goat
Esta sessão resolve o DID público de bsky.app, sem entrar nem alterar a conta. O documento indica o handle, a chave pública e o servidor na data da captura. Exportações e migrações usam outros comandos; consulte a fonte versionada do goat antes de as realizar.
goat goat version 0.2.9 ·
Leitura de dados públicos do AT Protocol · Código de saída 0
goat resolve did:plc:z72i7hdynmk6r22z27h6tvur{
"@context": [
"https://www.w3.org/ns/did/v1",
"https://w3id.org/security/multikey/v1",
"https://w3id.org/security/suites/secp256k1-2019/v1"
],
"id": "did:plc:z72i7hdynmk6r22z27h6tvur",
"alsoKnownAs": [
"at://bsky.app"
],
"verificationMethod": [
{
"id": "did:plc:z72i7hdynmk6r22z27h6tvur#atproto",
"type": "Multikey",
"controller": "did:plc:z72i7hdynmk6r22z27h6tvur",
"publicKeyMultibase": "zQ3shQo6TF2moaqMTrUZEM1jeuYRQXeHEx4evX9751y2qPqRA"
}
],
"service": [
{
"id": "#atproto_pds",
"type": "AtprotoPersonalDataServer",
"serviceEndpoint": "https://puffball.us-east.host.bsky.network"
}
]
}
Publicações e feed com bsky
A ajuda gravada vem do binário mattn/bsky 0.0.82 descarregado. Enumera operações de feed, publicação e conta. Não entrámos nem executámos escritas. A documentação original descreve capacidades, mas não demonstra que a nossa sessão testou todos os comandos.
bsky bsky version 0.0.82 ·
Comando local; sem ligação a uma conta · Código de saída 0
bsky --helpNAME: bsky - bsky USAGE: bsky [global options] command [command options] VERSION: 0.0.82 DESCRIPTION: A cli application for bluesky COMMANDS: show-profile Show profile update-profile Update profile show-session Show session timeline, tl Show timeline stream Show timeline as stream thread Show thread post Post new text vote Vote the post votes Show votes of the post repost Repost the post reposts Show reposts of the post follow Follow the handle unfollow Unfollow the handle follows Show follows followers Show followers block Block the handle unblock Unblock the handle blocks Show blocks mute Mute the handle unmute Unmute the handle mutes Show muted users report Report the handle moderation-list Add the handle to a new moderation list lists Show lists list Show list items chat Direct messages delete Delete the note search Search Bluesky search-actors Search Actors login Login the social notification, notif Show notifications invite-codes Show invite codes list-app-passwords Show App-passwords add-app-password Add App-password revoke-app-password Revoke App-password mcp Start MCP server help, h Shows a list of commands or help for one command GLOBAL OPTIONS: -a value profile name -V verbose (default: false) --help, -h show help --version, -v print the version
Restringir as credenciais à sua finalidade
O bsbot guarda o token em ~/.config/bsbot/credentials.json, com permissões exclusivas do utilizador; a duração predefinida é de 30 dias. bsbot logout revoga-o. O painel também pode revogar o acesso CLI. Evite credenciais em registos e código-fonte.
Num cliente que aceite uma palavra-passe do Bluesky, crie uma palavra-passe de aplicação. O goat documenta o armazenamento da palavra-passe de aplicação e tokens no disco; terminar a sessão elimina o ficheiro local. As credenciais de um cliente de publicação podem permitir posts e outras alterações, ao contrário do token de identificadores Bluesky.bot. Reveja permissões, armazenamento e revogação antes de automatizar.