AD
Boost Your Brand on BlueSky—Exclusive banner space to amplify your reach within the BlueSky community.
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

400stars
40forks
15contributors
10open issues

Dates

Created:March 5, 2023
Last updated:June 11, 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.

1139•Go
bluesky-socialjetstream

A simplified JSON event stream for AT Proto

392•Go
uabluerailindexer

ATproto PDS indexer

21•Go
CharlesDardamanblueskyfirehose

Simple golang firehose for Bluesky.

61•Go
danruseigobot-bsky

Bluesky Bot library in Go

18•Go
ericvolp12go-bsky-feed-generator

A minimal implementation of a BlueSky Feed Generator in Go

33•Go

Resources

GitHub Repository

License

MIT

Author

mattn
mattn
did:plc:xxxxxxxxxxxxxxxxxxxxxxxx

Activity

Last commit: June 11, 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 listFirsto

This website may contain affiliate links

© 2025 BskyInfo. All rights reserved.