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.

Versões e fontes verificadas em 16 de novembro de 2026. A ajuda e as leituras públicas não testam alterações autenticadas.
Ferramenta e versãoUso adequadoAutenticação e escritasInstalação e licençaFonte 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

bash
npm install --global @blueskydotbot/[email protected]
bsbot --version
bsbot --help

A 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

bash
bsbot --help
bsbot 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

bash
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.

bash
bsbot login
bsbot whoami
bsbot bots

Escolha o DID do seu bot e um nome livre. A sintaxe publicada é:

bash
bsbot claim BOT_DID chosen-name
bsbot switch BOT_DID
bsbot verify BOT_DID

Substitua 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

bash
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

bash
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

bash
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

bash
bsky --help
NAME:
   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.

Perguntas sobre os CLI do Bluesky

O bsbot pode publicar no Bluesky?
Não. A versão npm verificada gere identificadores Bluesky.bot e consulta o diretório. Para publicar use um cliente de publicação ou o SDK do AT Protocol.
Porque é bsbot doctor um comando desconhecido?
O pacote npm 0.1.0 gravado não inclui doctor nem listing. Um endpoint do servidor não acrescenta comandos ao CLI instalado. Consulte as notas de versão antes de depender de uma função recente.
Posso usar o bsbot publicado em CI com BSBOT_TOKEN?
O pacote 0.1.0 verificado não lê essa variável. O servidor oferece tokens de implementação limitados às fichas para pedidos HTTP diretos. Consulte a referência da API e guarde os segredos no cofre do CI.

Fontes