AD
Launch on Firsto—Launch your project today — get a DR57 backlink instantly.
BSkyInfo LogoBskyInfo
All ToolsCategoriesCollectionsFeed DirectoryLabeler DirectoryArticlesGuidesGlossaryBluesky SDKsSponsor
Submit
All ToolsCategoriesCollectionsFeed DirectoryLabeler DirectoryGuidesGlossaryArticlesBluesky SDKsSponsorSubmit
  1. SDKs
  2. /Go
  3. /bsky
mattn

bsky

A Go SDK for Bluesky and AT Protocol by mattn

A cli application for bluesky social

GitHub Stats

416stars
43forks
15contributors
10open issues

Dates

Created:March 5, 2023
Last updated:October 4, 2025

README

The following content is from bsky's GitHub repository. All rights reserved by the original author.

bsky

bluesky CLI client written in Go

Usage

NAME:
   bsky - bsky

USAGE:
   bsky [global options] command [command options]

VERSION:
   0.0.67

DESCRIPTION:
   A cli application for bluesky

COMMANDS:
   show-profile         Show profile
   update-profile       Update profile
   show-session         Show session
   timeline, tl         Show timeline
   stream               Show timeline as stream
   thread               Show thread
   post                 Post new text
   vote                 Vote the post
   votes                Show votes of the post
   repost               Repost the post
   reposts              Show reposts of the post
   follow               Follow the handle
   unfollow             Unfollow the handle
   follows              Show follows
   followers            Show followers
   block                Block the handle
   unblock              Unblock the handle
   blocks               Show blocks
   delete               Delete the note
   search               Search Bluesky
   login                Login the social
   notification, notif  Show notifications
   invite-codes         Show invite codes
   list-app-passwords   Show App-passwords
   add-app-password     Add App-password
   revoke-app-password  Revoke App-password
   help, h              Shows a list of commands or help for one command

GLOBAL OPTIONS:
   -a value       profile name
   -V             verbose (default: false)
   --help, -h     show help
   --version, -v  print the version
$ bsky login [handle] [password]
$ bsky timeline
$ bsky post -image ~/pizza.jpg 'I love 🍕'
$ bsky vote at://did:plc:xxxxxxxxxxxxxxxxxxxxxxxx/app.bsky.feed.post/yyyyyyyyyyyyy
$ bsky repost at://did:plc:xxxxxxxxxxxxxxxxxxxxxxxx/app.bsky.feed.post/yyyyyyyyyyyyy

Extended Usage Information

Individual commands have their own help texts. Call via -h / --help and the name of the command.

JSON Output

The output for most commands can be formatted as JSON via --json. See Extended Usage Information for the individual commands that support JSON output.

Installation

Download binary from Release page.

Or install with go install command.

go install github.com/mattn/bsky@latest

To enable Autocomplete

Download the correct file from /scripts directory and add the following line to your shell configuration file.

ZSH:

# Add the following line to your .zshrc
source /path/to/autocomplete.zsh

Bash:

# Add the following line to your .bashrc
source /path/to/autocomplete.sh

PowerShell:

# Add the following line to your $PROFILE
/path/to/autocomplete.ps1

License

MIT

Author

Yasuhiro Matsumoto (a.k.a. mattn)

Topics

bluesky

Related SDKs

bluesky-socialindigo

Go source code for Bluesky's atproto services.

1200•Go
bsky-watchlabeler

Basic ATproto labeler and a toolkit to make your own

22•Go
bluesky-socialjetstream

A simplified JSON event stream for AT Proto

420•Go
gugrayrss-parrot

Notifies Mastodon accounts about new posts in the RSS feeds they follow

156•Go
ThomasAFinkbluesky-personal-data-parser-json

Parse your public BlueSky data to json format.

5•Go
vvakameatproto-vvvot

@vvvot.bsky.social bot implementation

4•Go

Resources

GitHub Repository

License

MIT

Author

mattn
mattn
did:plc:xxxxxxxxxxxxxxxxxxxxxxxx

Activity

Last commit: October 4, 2025
Commit frequency: Unknown

Our Sponsors

Your Brand Here!

50K+ engaged viewers every month

Limited spots available!

📧 Contact us via email🦋 Contact us on Bluesky
BSkyInfo LogoBskyInfo

The Most Comprehensive Bluesky Tools Directory

Stay updated with the latest Bluesky tools and ecosystem news 🦋

Bluesky butterfly logo
Quick LinksSubmit a ToolSponsorAboutLegal Information
ToolsFeed DirectoryLabeler DirectorySchedulingAnalyticsAll ToolsCategoriesCollectionsTags
ResourcesArticlesBluesky GuidesBluesky GlossaryBluesky SDKsBluesky ResourcesSkyRaffleMeida Coverage
Our ProductsRaffleBlueAiTeach ToolsLaiewAI affiliate listFirstoCoast Fire CalculatorAsphalt CalculatorDog Names World

This website may contain affiliate links

© 2025 BskyInfo. All rights reserved.