Bluesky Account Management

Operate a Bluesky social media account via ./bsky <command> [args]. All output is JSON. Run from the project root.

Setup

Install dependencies:

pip install atproto python-dotenv

Requires .env at project root:

BLUESKY_HANDLE=your-handle.bsky.social
BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx

App passwords: https://bsky.app/settings/app-passwords. For DMs, enable "Allow access to your direct messages".

Auth is automatic. A session cache is stored at ~/.bsky_session.json (contains an exported session token). Delete this file to force re-authentication or when revoking access.