Bluesky en ligne de commande : quel CLI choisir ?

Utilisez bsbot pour vos pseudos Bluesky.bot, goat pour les opérations AT Protocol et un client de publication pour le fil et les posts. Chaque capture indique sa version et distingue l’aide locale des lectures publiques.

Par L’équipe Bluesky.bot

Publié:
Modifié:
Revu:

Choisir selon l’opération

Pour les pseudos name.bluesky.bot de vos bots, commencez par bsbot et sa référence. Pour résoudre une identité publique, exporter un dépôt, examiner un fichier CAR, lire l’historique PLC ou migrer un compte, consultez goat. Pour publier et lire le fil, regardez mattn/bsky ou un SDK AT Protocol. Les usages et permissions diffèrent.

Versions et sources vérifiées le 16 novembre 2026. L’aide et les lectures publiques ne testent pas les changements authentifiés.
Outil et versionUsage adaptéConnexion et écrituresInstallation et licenceSource et vérification

bsbot

0.1.0

TypeScript / Node.js ≥ 22

Publié le 12 nov. 2026

Gérer les pseudos Bluesky.bot de vos bots ; consulter les noms et l’annuaire publics. Il ne publie pas et ne lit pas de fil.OAuth dans le navigateur pour les actions du compte. Son jeton gère les pseudos et reste distinct d’un mot de passe d’application Bluesky.npm install --global @blueskydotbot/[email protected]

MIT

Source versionnée

Vérifié le 16 nov. 2026

goat

0.2.9

Go

Publié le 6 nov. 2026

Résoudre les identités, examiner les dépôts et fichiers CAR, lire l’historique PLC, exporter, administrer ou migrer des comptes.De nombreuses lectures sont publiques. Les écritures utilisent une connexion par mot de passe d’application ; le client documente le stockage local des identifiants.go install github.com/bluesky-social/[email protected]

MIT / Apache-2.0

Source versionnée

Vérifié le 16 nov. 2026

mattn/bsky

0.0.82

Go

Publié le 19 août 2026

Client Bluesky pour publier et lire le fil, avec des commandes de profil, suivi, modération et gestion du compte.La connexion documentée accepte un handle et un mot de passe. Utilisez un mot de passe d’application ; les commandes authentifiées peuvent modifier le compte.go install github.com/mattn/[email protected]

MIT

Source versionnée

Vérifié le 16 nov. 2026

La comparaison concerne les versions vérifiées, pas du code non publié. Nous avons exécuté les aides locales de bsbot et bsky, une vérification publique de nom avec bsbot et une résolution publique de DID avec goat. Aucune publication, migration ou modification de pseudo authentifiée n’a été exécutée.

Installer et vérifier la version

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

La version épinglée correspond à la capture. Pour une utilisation ponctuelle : npx @blueskydotbot/[email protected] --help. Lisez les notes avant de choisir une version plus récente. Les prérequis documentés sont Node.js 22 ou ultérieur sur macOS ou Linux ; la session utilise Linux et Node.js 24.

bsbot 0.1.0 ·

Commande locale, sans connexion à un compte · Code de sortie 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

Commencer par une lecture publique

check demande si un nom est libre. Il ne le réserve pas. Le nom capturé appartient au compte CLI du projet ; sa disponibilité et les suggestions peuvent changer.

bsbot 0.1.0 ·

Lecture seule de l’API publique Bluesky.bot · Code de sortie 0

bash
bsbot check cli --json
{
  "name": "cli",
  "handle": "cli.bluesky.bot",
  "available": false,
  "reason": "taken",
  "suggestions": [
    "cli2",
    "cli-24",
    "cli3"
  ]
}

Se connecter et gérer son bot

Les commandes suivantes sont des instructions, sans session authentifiée enregistrée. Ajoutez d’abord le bot dans le tableau de bord. Lancez bsbot login, vérifiez le compte et le nom de la machine dans le navigateur, puis autorisez. Aucun mot de passe Bluesky ne passe par bsbot. Son jeton concerne Bluesky.bot et ne permet pas de publier sur Bluesky.

bash
bsbot login
bsbot whoami
bsbot bots

Après avoir choisi le DID de votre bot et un nom libre, la syntaxe publiée est :

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

Remplacez les paramètres. claim réserve le nom et demande au serveur du bot de changer son pseudo ; switch relance cette demande. verify contrôle que le pseudo est actif. Lisez l’état retourné avant de recommencer : une réponse pending peut nécessiter de patienter, une réponse manual demande votre intervention. Voir la vérification du pseudo.

Doctor et CI : distinguer serveur et version publiée

Le paquet npm vérifié est 0.1.0, même si le dépôt source décrit des travaux plus récents. Il ne contient ni doctor, ni listing, ni prise en charge de BSBOT_TOKEN. Les captures de commande inconnue ci-dessous sont réelles ; elles ne montrent pas un diagnostic ou une modification réussis.

bsbot 0.1.0 ·

Commande locale, sans connexion à un compte · Code de sortie 2

bash
bsbot doctor --json
{"error":{"code":"usage","message":"Unknown command \"doctor\". See bsbot --help."}}

bsbot 0.1.0 ·

Commande locale, sans connexion à un compte · Code de sortie 2

bash
bsbot listing get cli --json
{"error":{"code":"usage","message":"Unknown command \"listing\". See bsbot --help."}}

Utilisez le diagnostic du tableau de bord. La référence API décrit les endpoints authentifiés de diagnostic et de fiche, ainsi que les jetons de déploiement limités aux fiches. Pour le CI, suivez ce contrat HTTP, gardez le secret dans le coffre du CI et limitez le jeton au bot concerné. Un exemple HTTP ne prouve pas la disponibilité d’une commande bsbot listing set non publiée. La référence CLI conserve les détails de compatibilité des commandes.

Lire AT Protocol avec goat

Cette session résout le DID public de bsky.app, sans connexion ni modification du compte. Le document retourné indique le handle, la clé publique et le serveur à la date de capture. Exporter un dépôt ou migrer un compte demande d’autres commandes ; consultez la source versionnée de goat avant de les utiliser.

goat goat version 0.2.9 ·

Lecture seule de données AT Protocol publiques · Code de sortie 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"
    }
  ]
}

Publier et lire le fil avec bsky

L’aide capturée provient du binaire mattn/bsky 0.0.82 téléchargé. Elle énumère les commandes de fil, publication et gestion de compte. Nous ne nous sommes pas connectés et n’avons exécuté aucune écriture. La documentation amont décrit les fonctions ; elle ne prouve pas que notre session les a toutes testées.

bsky bsky version 0.0.82 ·

Commande locale, sans connexion à un compte · Code de sortie 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

Garder chaque identifiant dans son périmètre

bsbot stocke son jeton dans ~/.config/bsbot/credentials.json, avec des droits réservés à l’utilisateur ; sa durée par défaut est de 30 jours. bsbot logout le révoque. Le tableau de bord peut aussi révoquer l’accès CLI. Évitez les identifiants dans les journaux et le code source.

Si un client accepte un mot de passe Bluesky, créez un mot de passe d’application. goat documente le stockage du mot de passe d’application et des jetons sur disque ; sa déconnexion supprime ce fichier local. Les identifiants d’un client de publication peuvent autoriser des posts et d’autres changements, contrairement au jeton de pseudos Bluesky.bot. Vérifiez les droits, le stockage et la révocation avant une automatisation.

Questions sur les CLI Bluesky

bsbot peut-il publier sur Bluesky ?
Non. La version npm vérifiée gère les pseudos Bluesky.bot et parcourt l’annuaire. Pour publier, utilisez un client de publication ou le SDK AT Protocol.
Pourquoi bsbot doctor est-il une commande inconnue ?
Le paquet npm 0.1.0 enregistré ne contient ni doctor ni listing. Un endpoint serveur n’ajoute pas de commande au CLI installé. Consultez les notes de version avant de compter sur une fonction récente.
Le bsbot publié fonctionne-t-il en CI avec BSBOT_TOKEN ?
Le paquet 0.1.0 vérifié ne lit pas cette variable. Le serveur propose des jetons de déploiement limités aux fiches, utilisables directement en HTTP. Suivez la référence API et conservez les secrets dans le coffre du CI.

Sources