| name | bluesky |
| version | 1.2.0 |
| description | Read, post, and interact with Bluesky (AT Protocol) via CLI. Use when user asks to check Bluesky, post to Bluesky, view their Bluesky timeline, search Bluesky, or check Bluesky notifications. Supports timeline, posting, profile lookup, search, and notifications. |
| homepage | https://bsky.app |
| metadata | {"moltbot":{"emoji":"🦋","requires":{"bins":"[Truncated]"}}} |
Bluesky CLI
Interact with Bluesky/AT Protocol from the command line.
Setup
First-time setup requires an app password from Bluesky:
- Go to bsky.app → Settings → Privacy and Security → App Passwords
- Create a new app password
- Run:
bsky login --handle yourhandle.bsky.social --password xxxx-xxxx-xxxx-xxxx
Security: Password is NOT stored. The CLI exports a session token on login, which auto-refreshes. Your app password only exists in memory during login.
Commands
bsky login --handle user.bsky.social --password xxxx-xxxx-xxxx-xxxx
bsky whoami
bsky timeline
bsky timeline -n 20
bsky tl
bsky post "Hello world!"
bsky p "Short post"
bsky post "Test" --dry-run
bsky --version
bsky delete <post_id>
bsky rm <url>
bsky profile
bsky profile @someone.bsky.social
bsky search "query"
bsky search "offsec" -n 20
bsky notifications
bsky notif -n 30
Output Format
Timeline and search results show:
@handle · Jan 25 14:30
Post text (truncated to 200 chars)
❤️ likes 🔁 reposts 💬 replies
🔗 https://bsky.app/profile/handle/post/id
Installation
The skill uses a Python virtual environment. On first run:
cd {baseDir}/scripts
python3 -m venv venv
./venv/bin/pip install atproto
Then run commands via:
{baseDir}/scripts/venv/bin/python {baseDir}/scripts/bsky.py [command]
Or use the wrapper script:
{baseDir}/scripts/bsky [command]