Skip to main content
Plugins / Bluesky Post

Bluesky Post

Post statuses to Bluesky.


Bluesky Post plugin

Woodpecker plugin to post statuses to Bluesky.

⚠️ Media attachments and facets (links, mentions) are not supported yet.

Usage

image: woodpeckerci/plugin-bluesky-post
settings:
  identifier: woodpecker-ci.org
  app_password:
    from_secret: bluesky_app_password
  text: We just released {{ CI_COMMIT_TAG }} 🚀

Settings

Setting Description Required? Default
service_url Bluesky service url, including protocol. No https://bsky.social
identifier Your Bluesky handle (without @) or did Yes
app_password Your Bluesky app password (How to get an app password) Yes
text Text to post (Allows Templating) Yes (if ai_token is not set)
media ,-separated list of paths to attachments No
in_reply_to_root Root ID of post to reply to No
in_reply_to_parent Parent ID of post to reply to No
languages ,-separated list of post languages No
tags ,-separated list of post tags No
labels ,-separated list of post labels No
ai_token Provide an AI token (OpenAI) to generate a post text Yes (if text is not set)
ai_model Select the model used to generate a post text No gpt-4o-mini
ai_prompt Prompt used to generate a post text. (Allows Templating) No prompt
changelog_file File to use for the AI to make a changelog from. No CHANGELOG.md

Get app password

In order to get an app password, go to https://bsky.app/settings/app-passwords and create a new app password.

Templating

You can use {{ CI_COMMIT_TAG }} and other environment variables in the status or ai_prompt settings. The ai_prompt template can also use {{ CHANGELOG }} to include the changelog of the release.