{"_id":"@blueskydotbot/cli","_rev":"3-c2508d4dc69bfa1cc476c1a539fd761d","name":"@blueskydotbot/cli","dist-tags":{"latest":"0.1.1"},"versions":{"0.0.0-stage":{"name":"@blueskydotbot/cli","version":"0.0.0-stage","_id":"@blueskydotbot/cli@0.0.0-stage","stub":true,"maintainers":[{"name":"pirmax","email":"pirmax@icloud.com"}],"dist":{"shasum":"6f848ceb39c4cd5a4cc33d3c03070e3294da9e27","tarball":"https://registry.npmjs.org/@blueskydotbot/cli/-/cli-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-sndCKrlPA5PoLbGK93h0ed0EYfpFN1UutsXZ4rDKW4qArwkZAb6/lRhXBtWByqNft/bUhWrmI0z2AM/bJhJ9eQ==","signatures":[{"sig":"MEYCIQD1xf1QfnfqvAdaFCLkJIZ11iUECsgKHn/DH3buvbpFTwIhAIsZ0mtQzjmi7EKcWFaBzLMOft54xNDtGYX/AOqvTXL/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":340},"_npmUser":{"name":"pirmax","email":"pirmax@icloud.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@blueskydotbot/cli","version":"0.1.0","keywords":["bluesky","atproto","bot","handle","cli"],"license":"MIT","_id":"@blueskydotbot/cli@0.1.0","maintainers":[{"name":"pirmax","email":"pirmax@icloud.com"}],"homepage":"https://bluesky.bot/docs/cli","bugs":{"url":"https://github.com/blueskydotbot/bsbot-cli/issues"},"bin":{"bsbot":"dist/bin.js"},"dist":{"shasum":"2d4e4f8b7bfd7bdca1e1fdb0354ddafb1226d1f5","tarball":"https://registry.npmjs.org/@blueskydotbot/cli/-/cli-0.1.0.tgz","fileCount":8,"integrity":"sha512-iZ76uIU35r2uMkmTOwDb/ZkO85/II71g95D1oOWwc6AyRciyomdO2IHJxNr3F/68T1t+9y+zRfuWlobkpDugbw==","signatures":[{"sig":"MEQCIA2qimL69lSl6umfN0auAvmqbZXSFP7Pygbcw8VOgsv0AiB2HdXIX1haCjrTBf4G63vlylRRaOcUrQkZ//FVJZczKQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCICSrGOYRUOGRXc/04ChM4XIpnxBJEUb3sLL4BvOZ8daaAiEAsaMof4dsjOSsaui1dc4hVkQtPwexgRVsmMH1PMS7LSU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31351},"type":"module","_from":"file:blueskydotbot-cli-0.1.0.tgz","engines":{"node":">=22"},"scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build","prepublishOnly":"node -e \"if(require('fs').existsSync('../../pnpm-workspace.yaml')){console.error('@blueskydotbot/cli is published from github.com/blueskydotbot/bsbot-cli, not from a workspace.');process.exit(1)}\""},"_npmUser":{"name":"pirmax","email":"pirmax@icloud.com"},"_resolved":"/Users/pirmax/Downloads/blueskydotbot-cli-0.1.0.tgz","_integrity":"sha512-iZ76uIU35r2uMkmTOwDb/ZkO85/II71g95D1oOWwc6AyRciyomdO2IHJxNr3F/68T1t+9y+zRfuWlobkpDugbw==","repository":{"url":"git+https://github.com/blueskydotbot/bsbot-cli.git","type":"git"},"_npmVersion":"12.2.2","description":"Manage your Bluesky bots and their name.bluesky.bot handles from the terminal.","directories":{},"_nodeVersion":"24.22.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"5.0.5","typescript":"6.0.3","@types/node":"24.19.2"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.1.0_1794481932571_0.164861409697583","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"_id":"@blueskydotbot/cli@0.1.1","bin":{"bsbot":"dist/bin.js"},"bugs":{"url":"https://github.com/blueskydotbot/cli/issues"},"dist":{"shasum":"4cccd330b8befcb0768937a87c5e38bf0880a9a1","tarball":"https://registry.npmjs.org/@blueskydotbot/cli/-/cli-0.1.1.tgz","fileCount":8,"integrity":"sha512-uuUccfCat+OlgxwPQj/A8O3dc5n5K62fFw6T/Lsh5DdP73ZwZGYXdWI7CC2/W7Wc7h62wCfS8sIaKQoMamhPBg==","signatures":[{"sig":"MEUCIDoD/FnqrqRMS44qqwAJ9o1dX629QcwcmtM7i5gLC1/aAiEA5G+7it1H+1QrUmlo6ib0e/liSrnnWJbyGKB5B1+iFPk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGU44y3z6WsC00ugoPJ/uF4pHTkXd8sInnFl4j53bf28AiAHQHZO8YlSLrbyxRBWU1MsCTZUKRBKotk5iwcORpBDww=="}],"unpackedSize":31953},"name":"@blueskydotbot/cli","type":"module","engines":{"node":">=22"},"gitHead":"5cc0ca387bc062534f5e6ddf88f15c2f8b6e939c","license":"MIT","scripts":{"test":"vitest run","build":"tsc -p tsconfig.json","prepack":"npm run build"},"version":"0.1.1","_npmUser":{"name":"pirmax","email":"pirmax@icloud.com"},"homepage":"https://bluesky.bot/docs/cli","keywords":["bluesky","atproto","bot","handle","cli"],"repository":{"url":"git+https://github.com/blueskydotbot/cli.git","type":"git"},"_npmVersion":"12.2.2","description":"Manage your Bluesky bots and their name.bluesky.bot handles from the terminal.","directories":{},"maintainers":[{"name":"pirmax","email":"pirmax@icloud.com"}],"_nodeVersion":"24.22.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"5.0.5","typescript":"6.0.3","@types/node":"24.19.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.1.1_1794903967378_0.9000678704429853"}}},"time":{"created":"2026-11-12T11:09:34.865Z","modified":"2026-11-17T08:26:07.810Z","0.0.0-stage":"2026-11-12T11:09:34.865Z","0.1.0":"2026-11-12T11:12:12.658Z","0.1.1":"2026-11-17T08:26:07.492Z"},"bugs":{"url":"https://github.com/blueskydotbot/cli/issues"},"license":"MIT","homepage":"https://bluesky.bot/docs/cli","keywords":["bluesky","atproto","bot","handle","cli"],"repository":{"url":"git+https://github.com/blueskydotbot/cli.git","type":"git"},"description":"Manage your Bluesky bots and their name.bluesky.bot handles from the terminal.","maintainers":[{"name":"pirmax","email":"pirmax@icloud.com"}],"readme":"[![cli.bluesky.bot on Bluesky.bot](https://bluesky.bot/badge/cli.bluesky.bot.svg)](https://bluesky.bot/bots/cli)\n\n# bsbot\n\nManage your Bluesky bots and their `name.bluesky.bot` handles from the\nterminal: sign in with Bluesky, then claim, switch, verify and release handles.\nNo dependencies, Node.js 22+.\n\nSigning in happens in your browser, so no password ever goes through the\nterminal. You can also list your bots and browse the directory of\n[Bluesky.bot](https://bluesky.bot).\n\n```bash\nnpm install --global @blueskydotbot/cli\nbsbot login\nbsbot check weather\nbsbot claim weather.bsky.social weather\nbsbot verify weather\n```\n\n## Install\n\nThe npm package is\n[`@blueskydotbot/cli`](https://www.npmjs.com/package/@blueskydotbot/cli); the\ncommand it installs is `bsbot`. Install it once:\n\n```bash\nnpm install --global @blueskydotbot/cli\nbsbot --help\n```\n\nOr run it without installing, with `npx @blueskydotbot/cli <command>` (for\nexample `npx @blueskydotbot/cli login`). Other package managers work too:\n`pnpm dlx @blueskydotbot/cli`, `yarn dlx @blueskydotbot/cli` or\n`bunx @blueskydotbot/cli`.\n\nRequirements: macOS or Linux, Node.js 22 or later. No dependency.\n\n## Usage\n\n| Command | What it does |\n| --- | --- |\n| `login` | Signs in through the browser (`--no-browser`, `--name <label>`) |\n| `logout` | Revokes this machine's token and forgets it |\n| `whoami` | The account you are signed in as |\n| `bots` | Your bots, their handle, and whether it is live |\n| `check <name>` | Whether `<name>.bluesky.bot` is free (no sign-in needed) |\n| `claim <bot> <name>` | Claims `<name>.bluesky.bot` for a bot and switches the bot to it |\n| `switch <bot>` | Asks the bot's server again to use its handle |\n| `verify <bot>` | Checks that the handle is live on Bluesky |\n| `release <bot>` | Gives the handle up (asks first, or add `--yes`) |\n| `directory` | Browses the public directory (`--q`, `--category`, `--verified`, `--limit`, `--cursor`) |\n\n`<bot>` is a bot's DID, its handle, its previous handle, or the name of its\n`.bluesky.bot` handle. Every command takes `--json` for scripts; the exit code\nis `0` on success, `1` on an error and `2` on a usage mistake. Run\n`bsbot --help` for the details, and see https://bluesky.bot/docs/cli.\n\n## Bugs and ideas\n\nFound a bug or missing a command? Open an issue at\nhttps://github.com/blueskydotbot/cli/issues with the version\n(`bsbot --version`), the command and what it printed. Never paste your token.\n\n## Security\n\n- The token is saved in `~/.config/bsbot/credentials.json` (or\n  `$XDG_CONFIG_HOME/bsbot/`, or `$BSBOT_CONFIG_DIR`), readable by you only.\n  It lasts 30 days and is never printed, not even with `--json`.\n- It can only manage your bots' handles: it cannot post, follow, read your\n  Bluesky account or change your settings.\n- `bsbot logout` revokes it; so does **Settings → CLI access** on\n  bluesky.bot.\n\nReport vulnerabilities privately: see [SECURITY.md](SECURITY.md).\n\n## Development\n\n```bash\nnpm ci\nnpm test\nnpm run build\nnode dist/bin.js --help\n```\n\nNode.js 24 can also run the TypeScript sources directly:\n`node src/bin.ts --help`.\n\n`--api-url <url>` (or `BSBOT_API_URL`) points the CLI at another server; plain\n`http` is only accepted for `localhost`, `127.0.0.1` and `[::1]`. When you\ntry a change against a local development server of bluesky.bot, keep its\ncredentials apart from your real ones:\n\n```bash\nexport BSBOT_CONFIG_DIR=\"$(mktemp -d)\"\nnode dist/bin.js check weather --api-url http://localhost:3000\nnode dist/bin.js login --api-url http://localhost:3000\n```\n\nCredentials are bound to the server that issued them: switching servers needs\na new `login`.\n\n## Contributing\n\nBug reports and ideas are welcome in\n[GitHub issues](https://github.com/blueskydotbot/cli/issues). For a pull\nrequest, open an issue first for anything larger than a small fix, keep the\nCLI free of runtime dependencies, add tests, and add a line to the\n`[Unreleased]` section of [CHANGELOG.md](CHANGELOG.md). `npm test` and\n`npm run build` must pass.\n\nEach stable version gets a GitHub Release with its changelog, and is announced\non Bluesky by [@cli.bluesky.bot](https://bsky.app/profile/cli.bluesky.bot):\nfollow it to hear about new versions. Maintainers release as described in\n[RELEASING.md](RELEASING.md).\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}