The Bluesky Plugin for Obsidian offers a seamless way to post directly to the Bluesky platform from within your vault. With a new "megaphone" icon conveniently added to the sidebar, users can easily compose posts or threads without leaving the app. Whether you want to share a quick thought or a detailed thread, this plugin streamlines the process.

Setting up is simple: enter your Bluesky handle and app password (generated via the Bluesky settings). Once configured, you can use the sidebar icon or a command palette shortcut to open a dedicated Bluesky tab, draft your post, and share it instantly.

For those actively engaging on Bluesky, this plugin is a great way to stay connected while focusing on your work in Obsidian, eliminating the need to switch between apps.

Bluesky Plugin

Post to Bluesky via a Tab view or by highlighting text

Usage Guide

Initial Setup

Open the Bluesky plugin in the Obsidian settings.
Enter your Bluesky handle (e.g. evanharris.bsky.social).
Enter a Bluesky App Password - Note: Please do not enter your Bluesky password here.
- If you do not have an App Password, you can create one by going to the App Passwords page and creating a new App Password.

How to Post

A new megaphone icon will appear in the left sidebar after you install the plugin.

To compose a post or a thread:
- Click the megaphone icon to open a Bluesky tab.
- Write your post or thread.
- Click "Post" to post to Bluesky.
If you prefer to use the command palette, you can run the Open Bluesky tab command.

Reply to a post

You can add your post (or a whole thread) as a reply that continues an existing Bluesky post.

Open the Bluesky tab.
Paste the post's URL (e.g. https://bsky.app/profile/handle/post/...) into the Reply to a Bluesky post field at the top.
The plugin looks up the post and shows a preview so you can confirm the target.
Write your post or thread and click "Post" — it will be attached as a reply.

Leave the field empty to post normally. Any public post can be replied to.

Network use & privacy

This plugin only contacts the network for the following, all initiated by you:

Bluesky (bsky.social) - to authenticate with your App Password, to publish posts, threads, and uploaded images via the AT Protocol (@atproto/api), and to look up a post you choose to reply to. Your credentials are stored locally and sent only to Bluesky.
Link preview generation - when your post includes a URL, the plugin fetches that URL (and its preview image) to build the embedded link card. This means it contacts whatever domain you linked to.

No telemetry or analytics are collected. The plugin makes no network requests unless you post or include a link.

Testing

npm run test:e2e

Runs provider-free UI smoke tests against a real, sandboxed Obsidian instance via wdio-obsidian-service — no Bluesky credentials, no network calls, no contact with your real vault. See test/README.md for details.

[!WARNING] When touching the test config, never point plugins: in wdio.conf.mts at the repo root ("."). wdio-obsidian-service copies data.json — which holds your real Bluesky app password — from the plugin directory into every test vault. Always go through the staged copy in test/plugin-dist/ (scripts/stage-plugin.mjs).

Say Hi

Bluesky

Roadmap

Media
Embeds
Posting threads from within a file
Language specification

Attribution

This project builds upon the Bluesky AT Protocol, which is licensed under the MIT License.

The source code of this project includes parts of the Bluesky AT Protocol, following the MIT License requirements.

Bluesky

Description

Reviews

Stats

Latest Version

Changelog

What's Changed

README file from