🦞 clawbsky

A full-featured, professional Bluesky CLI designed for power users and automation.

✨ Key Features

• Media Support: Post images and videos with automatic metadata/aspect ratio detection.
• Growth Tools: Identify and unfollow accounts that don't follow you back (unfollow-non-mutuals).
• Thread Management: Create long threads automatically from multiple text strings.
• Search & Explore: Deep search for posts, users, and hashtags.
• Moderation: Quick block, mute, and notification management.

🚀 Setup

1. Get an App Password: Go to Bluesky Settings and create a new App Password. NEVER use your main account password.
2. Install:

   npm install
   

3. Configure:

   clawbsky login
   

🛠 Commands

Growth & Maintenance

clawbsky unfollow-non-mutuals -n 50 # Unfollow top 50 non-mutuals
clawbsky follow-all "Query" -n 20   # Auto-follow users matching a topic

Posting & Threads

clawbsky post "Text" [media...]          # Create a post
clawbsky thread "Part 1" "Part 2" ...     # Create a multi-post thread
clawbsky quote <uri> "My thoughts"      # Quote a post

Reading

clawbsky home -n 20              # View your timeline
clawbsky user <handle>           # Inspect a profile
clawbsky user-posts <handle>     # View user's recent activity
clawbsky thread <uri>            # Read a full conversation branch

Engagement & Moderation

clawbsky like/repost <uri>       # Engage with content
clawbsky block/mute <handle>     # Manage your boundaries
clawbsky notifications           # Check recent interactions

💡 Advanced Usage

Global Options

• --json: Get raw data for piping to other tools.
• --plain: Disable emojis and formatting for cleaner logs.
• -n <count>: Limit results (default: 10).
• --dry-run: Preview actions (like unfollowing) without executing.

🛡 Safety & Ethics

Clawbsky provides powerful automation tools. To protect your account and the Bluesky community:

1. Be Human: Do not use follow-all to search and follow thousands of users daily. This is considered spam and will lead to an account ban.
2. Respect Limits: Use unfollow-non-mutuals for periodic maintenance, not for "follow/unfollow" churning.
3. App Passwords: Only use App Passwords. If you suspect your credentials have been compromised, revoke the App Password immediately in your Bluesky settings.
4. Rate Limiting: The tool includes built-in delays (1s/follow) to prevent hitting API limits. Do not attempt to disable these.

Responsibility for account actions lies solely with the user.

Automatic Logic

• Handle Completion: @username or username automatically resolves to username.bsky.social.
• Rich Text: Mentions and links are auto-detected and facet-encoded for the AT Protocol.
• Video Processing: Automatically polls the Bluesky video service until processing completes.

Built for the AT Protocol community.