mirror of
https://github.com/hanzoskill/bluesky.git
synced 2026-10-30 21:11:42 +00:00
1.9 KiB
1.9 KiB
name, description, homepage, metadata
| name | description | homepage | metadata | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| bluesky | 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. | https://bsky.app |
|
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
Credentials are stored in ~/.config/bsky/config.json.
Commands
# Authentication
bsky login --handle user.bsky.social --password xxxx-xxxx-xxxx-xxxx
bsky whoami
# Timeline
bsky timeline # Show home feed (10 posts)
bsky timeline -n 20 # Show 20 posts
bsky tl # Alias
# Posting
bsky post "Hello world!" # Create a post
bsky p "Short post" # Alias
# Profiles
bsky profile # Your profile
bsky profile @someone.bsky.social
# Search
bsky search "query" # Search posts
bsky search "offsec" -n 20
# Notifications
bsky notifications # Likes, reposts, follows, mentions
bsky notif -n 30 # Alias with count
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]