🦞 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. 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
   

1. 3. Configure:

🛠 Commands

Growth & Maintenance

Posting & Threads

Reading

Engagement & Moderation

💡 Advanced Usage

Global Options

• - --json: Get raw data for piping to other tools.
• INLINECODE2: Disable emojis and formatting for cleaner logs.
• INLINECODE3: Limit results (default: 10).
• INLINECODE4: Preview actions (like unfollowing) without executing.

🛡 Safety & Ethics

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

1. 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.