mirror of
https://github.com/hanzoskill/bluesky.git
synced 2026-10-30 21:11:42 +00:00
1.5 KiB
1.5 KiB
๐ฆ Bluesky Skill
A Bot skill for interacting with Bluesky (AT Protocol) from the command line.
Features
- Timeline - View your home feed
- Post - Create new posts
- Search - Search posts across Bluesky
- Notifications - Check likes, reposts, follows, mentions
- Profile - Look up user profiles
Setup
1. Get an App Password
- Go to bsky.app โ Settings โ Privacy and Security โ App Passwords
- Create a new app password (looks like
xxxx-xxxx-xxxx-xxxx)
2. Login
bsky login --handle yourhandle.bsky.social --password xxxx-xxxx-xxxx-xxxx
Credentials are stored in ~/.config/bsky/config.json.
3. Verify
bsky whoami
Usage
# Timeline
bsky timeline # Show 10 posts
bsky tl -n 20 # Show 20 posts
# Post
bsky post "Hello Bluesky!"
bsky p "Short post" # Alias
# Search
bsky search "query"
bsky search "offsec" -n 20
# Notifications
bsky notifications
bsky notif -n 30
# Profile
bsky profile # Your profile
bsky profile @someone.bsky.social # Someone else's
Output Format
@handle ยท Jan 25 14:30
Post text here...
โค๏ธ 42 ๐ 5 ๐ฌ 3
๐ https://bsky.app/profile/handle/post/id
Requirements
- Python 3.8+
atprotopackage (auto-installed on first run)
Installation
Via Skills:
skills install bluesky
License
MIT
Built for Bot