bsky - A Command-line Bluesky Client
# create user session
$ bsky login [handle] [password]
# view recent posts
$ bsky timeline ...
# create a post
$ bsky post ...
bsky is a simple command line client for Bluesky in Perl.
bsky [global options] command [command options] [arguments...]
# Print all configuration values
bsky config
# Print a single config value and exit
bsky config wrap
# Set a configuration value
bsky config wrap 100
View or change configuration values. See Configuration for a list of current options.
key optional
value optional
bsky show-profile
bsky show-profile --handle sankor.bsky.social
bsky show-profile --json
Show profile.
--handle handle user handle; defaults to the logged in account
-H handle alternative to --handle
--json boolean flag; content is printed as JSON objects if given
bsky update-profile --description "Looks like we made it!"
bsky update-profile --name "John Smith"
bsky update-profile --avatar https://cataas.com/cat?width=100 --banner https://cataas.com/cat?width=1000
Update profile elements.
--avatar optional, avatar image (url or local path)
--banner optional, banner image (url or local path)
--description optional, blurb about yourself
--name optional, display name
bsky show-session
bsky show-session --json
Show current session.
--json boolean flag; content is printed as JSON objects if given
bsky timeline
bsky timeline --json
# shorthand:
bsky tl
Display posts from timeline.
--json boolean flag; content is printed as JSON objects if given
thread at://did:plc:pwqewimhd3rxc4hg6ztwrcyj/app.bsky.feed.post/3kjyoh75qne2w
Show a thread.
--json boolean flag; content is printed as JSON objects if given
-n value number of items
post "This is a test"
Create a new post.
bsky like at://did:plc:pwqewimhd3rxc4hg6ztwrcyj/app.bsky.feed.post/3kjyoh75qne2w
Like a post.
bsky unlike at://did:plc:pwqewimhd3rxc4hg6ztwrcyj/app.bsky.feed.post/3kjyoh75qne2w
bsky unlike at://did:plc:pwqewimhd3rxc4hg6ztwrcyj/app.bsky.feed.like/3kjyml72tqu2y
Unlike a post. Either the direct feed URI or the like URI printed by bsky like ....
bsky likes at://did:plc:pwqewimhd3rxc4hg6ztwrcyj/app.bsky.feed.post/3kjyoh75qne2w
Show likes on a post.
--json boolean flag; content is printed as JSON objects if given
bsky repost at://did:plc:pwqewimhd3rxc4hg6ztwrcyj/app.bsky.feed.post/3kjyoh75qne2w
Repost the post.
bsky reposts at://did:plc:pwqewimhd3rxc4hg6ztwrcyj/app.bsky.feed.post/3kjyoh75qne2w
Show reposts of the post.
--json boolean flag; content is printed as JSON objects if given
bsky follow [handle]
bsky follow sankor.bsky.social
bsky follow did:plc:2lk3pbakx2erxgotvzyeuyem
Follow the handle
handle user handle or DID
bsky unfollow [handle]
bsky unfollow sankor.bsky.social
bsky unfollow did:plc:2lk3pbakx2erxgotvzyeuyem
Unfollow the handle
handle user handle or DID
bsky follows
bsky follows --handle sankor.bsky.social
bsky follows --json
Show follows.
--handle handle user handle; defaults to the logged in account
-H handle alternative to --handle
--json boolean flag; content is printed as JSON objects if given
bsky followers
bsky followers --handle sankor.bsky.social
bsky followers --json
Show followers.
--handle handle user handle; defaults to the logged in account
-H handle alternative to --handle
--json boolean flag; content is printed as JSON objects if given
bsky block [handle]
bsky block sankor.bsky.social
bsky block did:plc:2lk3pbakx2erxgotvzyeuyem
Block the handle.
handle user handle or DID
bsky unblock [handle]
bsky unblock sankor.bsky.social
bsky unblock did:plc:2lk3pbakx2erxgotvzyeuyem
Unblock the handle.
handle user handle or DID
bsky blocks
bsky blocks --json
Show blocks.
--json boolean flag; content is printed as JSON objects if given
bsky delete at://did:p...
Delete a post, repost, etc.
bsky notifications
bsky notifications --all
bsky notifications --json
# shorthand
bsky notif --all
Show notifications.
--all boolean flag, show all notifications
--json boolean flag; content is printed as JSON objects if given
bsky invite-codes
bsky invite-codes --json
Show invite codes.
Note that you must be logged in with the account password to view invite codes.
--json boolean flag; content is printed as JSON objects if given
bsky add-app-password "Your app name"
Create a new App password.
Note that you must be logged in with the account password to add a new app password.
bsky revoke-app-password "Your app name"
Delete App password.
Note that you must be logged in with the account password to revoke an app password.
bsky list-app-passwords
bsky list-app-passwords --json
Show App passwords.
--json boolean flag; content is printed as JSON objects if given
bsky login [ident] [password] [--host http://bsky.social]
Log into a Bluesky account.
ident
password
--host optional, defaults to https://bsky.social
shows a list of commands or help for one command
--help, -h show help
--version, -v print the version
-V print verbose version info
Current configuration values include:
-
wrapbsky config wrap 100Sets word wrap width in characters for terminal output. The default is
0which disables word wrap.
At.pm
Bluesky.pm
https://github.com/mattn/bsky - Original Golang client
Copyright (C) Sanko Robinson.
This library is free software; you can redistribute it and/or modify it under the terms found in the Artistic License 2. Other copyrights, terms, and conditions may apply to data transmitted through this module.
Sanko Robinson sanko@cpan.org