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.
| Outil et version | Usage adapté | Connexion et écritures | Installation et licence | Source 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
npm install --global @blueskydotbot/[email protected]
bsbot --version
bsbot --helpLa 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
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
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
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.
bsbot login
bsbot whoami
bsbot botsAprès avoir choisi le DID de votre bot et un nom libre, la syntaxe publiée est :
bsbot claim BOT_DID chosen-name
bsbot switch BOT_DID
bsbot verify BOT_DIDRemplacez 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
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
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
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
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
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.