Bluesky posts with Claude Code and Bolta
Turn your repo's release notes into social drafts, from the terminal. Parts of the Claude Code route are not confirmed yet, and the note below says which. Nothing goes live on Bluesky until you say yes.
Partly confirmed, see what is and is notChecked 2026-11-21
Two slash commands, then a browser sign-in. You tick the brands Claude Code may reach.
Read the top entry in CHANGELOG.md and draft a Bluesky post about it under 300 characters
Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.
What is and is not confirmed
Read this before you set up Claude Code
- Confirmed in Claude Code's official docs: remote HTTP MCP servers with browser sign-in through /mcp, skills as SKILL.md folders, and plugin marketplaces added from a GitHub repo.
- Bolta's own plugin is the most tested path. A full real-world run on every setup is still beta (plugin v0.5.3).
- Not confirmed here: the exact minimum Claude Code version for plugin marketplaces (the Bolta plugin README names 2.1.295 or later only as an example), and running Bolta end to end from claude -p in scripts. Claude Code's docs say headless runs cannot do the browser sign-in. The API key header route follows Claude Code's documented --header option but was not run end to end.
What Bolta does on Bluesky
Bolta cuts Bluesky text at 300 characters and ends it with an ellipsis, so the useful part of a draft has to come before the limit.
- Text posts of up to 300 characters, cut with an ellipsis beyond that.
- Images. A video is left off, and Bolta publishes the text and any images.
Bluesky limits and format rules
Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.
Not promised for Bluesky from Claude Code: Custom feeds and quote posts. Neither is confirmed for Bolta. Any Bluesky rule beyond what Bolta reports. This page states Bolta's limits, not a network rulebook.
| What to know | Bluesky's own rule | What Bolta does |
|---|---|---|
| Post length | Not stated on this page. | 300 characters. Longer text is cut short and ends with an ellipsis. |
| Media | Not stated on this page. | Images are posted. A video is skipped with a warning, and the text and any images still go out. |
| Threads | Not stated on this page. | Parts after the first are posted as replies, so they read as one Bluesky thread. |
| Formatting | Not stated on this page. | Bluesky shows plain text, so Bolta flattens markdown and leaves #hashtags and @mentions as typed. |
Claude Code jobs for Bluesky, and how to write them
- Draft launch posts from a README section before you push a release
- Summarise what a merged pull request changed in plain words for customers
- Write to 300 characters yourself. The cut is blunt and ends in an ellipsis.
Example prompts for Bluesky
Things to type in Claude Code. Each one asks for a draft and shows you the text first.
Read the top entry in CHANGELOG.md and draft a Bluesky post about it under 300 characters
Set up a routine that drafts a post from our product updates every Monday, and show me the plan first.
Turn the release notes into a three-part Bluesky thread and show me each part before saving
Send the three drafts you just saved to our reviewer for approval, and do not publish anything.
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
Claude Code asks Bolta for the Bluesky post in your brand voice (save-post). A saved draft is never public.
- 02
You read the exact text
On Bluesky the exact text includes where the 300-character cut would fall, and which images are attached, because a video would be left off.
- 03
You say yes
Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.
Using Claude Code for Bluesky
Parts of this route are not confirmed. The note above says which.
For Bluesky, Claude Code, from Anthropic, reaches Bolta through Plugin from the bolta-skills marketplace, or claude mcp add. Sign-in: Sign in (OAuth) from /mcp. The Bluesky account itself is connected inside Bolta, not in Claude Code.
Claude Code is a terminal coding agent, so the natural Bluesky job is turning a changelog, README or release notes already in your repo into a draft. Bolta's plugin for it bundles the connection and a skill.
An illustration from the Claude Code guide, not real output. You ask: Which Bolta brands can you see, and which accounts are connected to each? Do not change anything. The reply goes along these lines: These are the brands you ticked when you signed in, with their connected networks listed under each. If a brand is missing, run /mcp, pick Bolta and sign in again to tick it. Read only. Nothing changed.
An illustration from the Claude Code guide, not real output. You ask: Which of my recent posts got the most engagement, and what should I write about next? Read only. The reply goes along these lines: I looked at your recent posts and account results and ranked them from what Bolta has recorded. I suggest topics from the top performers and save nothing. Numbers are only as fresh as Bolta's latest sync, so a very new post may show little. Read only. Nothing changed.
Point it at a changelog, a README section, release notes or a diff summary and ask for drafts. It uses your Bolta voice and your posting rules, saves the drafts to Bolta and waits.
Claude Code reads the files itself, so there is no copy and paste between your editor and a scheduling tool.
The plugin installs the connection and the skill. If you already added Bolta yourself, installing the plugin on top leaves two Bolta entries on one organization. In that case add only the skill with npx skills add boltaai/bolta-skills --skill bolta.
- Review without a browser tab. See what is waiting, approve after you say yes, or reject with your own reason so Bolta learns your taste.
- Plan repeating work. Describe a routine in words, read the plan back, and save it switched off until you say yes to turn it on.
- Find which brand to use. It lists the brands you ticked at sign-in. With more than one, it asks which you mean instead of picking for you.
- Read the network's rules. It checks limits such as length and media needs for the network, so the draft fits.
- Setup: Install the Bolta plugin. Run /plugin install bolta@bolta-marketplace and pick user scope unless you know you want another. The plugin brings the connection to https://mcp.bolta.ai/mcp and the Bolta skill together. If the summary says to run /reload-plugins, run it.
- Setup: Sign in from /mcp. Run /mcp, select Bolta and choose sign in. Your browser opens on bolta.ai. Sign in, pick your organization and tick the brands this connection may reach. There is no key to copy.
- Skill only via npx skills add. npx skills add boltaai/bolta-skills --skill bolta. Use it when Bolta is already connected, so you keep one entry.
- You can check what a routine did with list-routine-runs, or switch it off with pause-routine.
- Plain MCP. Choose this if you manage connections by hand or in a team file. Claude Code adds remote servers with claude mcp add --transport http and the address https://mcp.bolta.ai/mcp, then /mcp signs you in. You get the connection without the skill, so add the skill too.
Connect Claude Code to Bolta
Two slash commands, then a browser sign-in. You tick the brands Claude Code may reach.
Bluesky questions, answered for Claude Code
- Can Claude Code post a video to Bluesky?
- Not through Bolta. Bolta publishes the text and any images and leaves a video off, with a warning. Use images, or post the video on another network.
- What is the Bluesky length limit for posts from Claude Code?
- 300 characters. Longer text is cut short and ends with an ellipsis, so write to the limit and read the final text before you say yes.
- How do I connect Bolta to Claude Code?
- Run /plugin marketplace add boltaai/bolta-skills, then /plugin install bolta@bolta-marketplace, then /mcp and sign in. Your browser opens on bolta.ai and you tick the brands Claude Code may reach.
- Claude Code does not see the Bolta tools. What should I check?
- Run /reload-plugins, then /mcp, and make sure Bolta shows as connected rather than needing sign-in. If you see two Bolta entries, remove one.
- Claude says the sign-in expired or you are not authenticated.
- Run /mcp, pick Bolta and sign in again. Sign-ins last 60 days and normally renew themselves. Claude should not retry in a loop.
- Every Bolta save is blocked on Windows.
- You have bolta-checks installed and no sh or awk. Install Git for Windows and restart Claude Code, or uninstall bolta-checks.
- Does Claude Code publish Bluesky posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Bluesky post. Whether Claude Code completes the connection is not fully confirmed, so read the note above first.
More from Claude Code
Claude Code can work with the other networks Bolta publishes to. Each page has its own limits and review notes.
Bluesky from other AI agents
The same Bluesky limits apply whichever agent asks. The connection and the setup are what change.
Try a Bluesky draft from Claude Code
Connect Claude Code, ask for a Bluesky draft and read the exact text. Nothing goes live until you say yes.