bluesky

name	bluesky
description	Post, reply, like, and repost on Bluesky using the lettabot-bluesky CLI. Read-only by default; explicit actions required.
metadata	{ "clawdbot": { "emoji": "🦋", "primaryEnv": "BLUESKY_HANDLE" } }

Bluesky

Bluesky is read-only by default in Lettabot. To post, reply, like, or repost you must use the lettabot-bluesky CLI.

Availability

When this skill is enabled, it ships a skill-local lettabot-bluesky shim, so the command is available to agent subprocesses without separate npm install.

Both entrypoints are supported and equivalent:

lettabot-bluesky <command> ...
lettabot bluesky <command> ...

The shim prefers project-local entrypoints (./dist/cli.js or ./src/cli.ts) before falling back to an installed lettabot binary on PATH.

Quick Reference

lettabot-bluesky post --text "Hello" --agent <name>
lettabot-bluesky post --reply-to at://did:plc:.../app.bsky.feed.post/... --text "Reply" --agent <name>
lettabot-bluesky post --text "Long..." --threaded --agent <name>
lettabot-bluesky post --text "Check this out" --image data/outbound/photo.jpg --alt "Alt text" --agent <name>
lettabot-bluesky post --text "Gallery" --image data/outbound/a.jpg --alt "First" --image data/outbound/b.jpg --alt "Second" --agent <name>
lettabot-bluesky like at://did:plc:.../app.bsky.feed.post/... --agent <name>
lettabot-bluesky repost at://did:plc:.../app.bsky.feed.post/... --agent <name>
lettabot-bluesky repost at://did:plc:.../app.bsky.feed.post/... --text "Quote" --agent <name> [--threaded]

Read Commands (public API)

lettabot-bluesky profile <did|handle> --agent <name>
lettabot-bluesky thread <at://did:plc:.../app.bsky.feed.post/...> --agent <name>
lettabot-bluesky author-feed <did|handle> --limit 25 --cursor <cursor> --agent <name>
lettabot-bluesky list-feed <listUri> --limit 25 --cursor <cursor> --agent <name>
lettabot-bluesky resolve <handle> --agent <name>
lettabot-bluesky followers <did|handle> --limit 25 --agent <name>
lettabot-bluesky follows <did|handle> --limit 25 --agent <name>
lettabot-bluesky lists <did|handle> --limit 25 --agent <name>
lettabot-bluesky actor-feeds <did|handle> --limit 25 --agent <name>

Auth‑Required Reads (uses app password)

lettabot-bluesky search --query "memory agents" --limit 25 --cursor <cursor> --agent <name>
lettabot-bluesky timeline --limit 25 --cursor <cursor> --agent <name>
lettabot-bluesky notifications --limit 25 --cursor <cursor> --reasons mention,reply --agent <name>

Moderation (Mute / Block)

lettabot-bluesky mute <did|handle> --agent <name>
lettabot-bluesky unmute <did|handle> --agent <name>
lettabot-bluesky block <did|handle> --agent <name>
lettabot-bluesky unblock <blockUri> --agent <name>
lettabot-bluesky blocks --limit 50 --cursor <cursor> --agent <name>
lettabot-bluesky mutes --limit 50 --cursor <cursor> --agent <name>

Notes:

• unblock requires the block record URI (returned by the block command).
• Pagination: many commands support --cursor (use the cursor field from the previous response).

Notes

• Posts are capped at 300 characters unless you pass --threaded.
• --threaded splits text into a reply thread (explicit opt‑in).
• Replies and quotes require the target at:// URI (included in incoming Bluesky messages).
• The CLI uses the Bluesky app password from your lettabot.yaml for the selected agent.
• Images: up to 4 per post; supported formats: JPEG, PNG, GIF, WebP. Use --image <path> (up to 4×) and --alt <text> after each image for alt text. --alt applies to the immediately preceding --image. Images must be inside the configured sendFileDir (default: data/outbound). Images attach to the first post only when --threaded.