// readme

goat: Go AT protocol CLI tool

This is a general purpose atproto CLI tool, sort of like curl. You can fetch at:// URIs, monitor the full-network firehose, migrate accounts, administer PDS instances, and more.

Install

If you use homebrew, you can install directly:

brew install goat

Pre-built binaries and Debian/Ubuntu packages are available under Releases.

If you have the Go toolchain installed and configured correctly, you can directly build and install the tool for your local account:

go install github.com/bluesky-social/goat@latest

Usage

goat is relatively self-documenting via help pages:

goat --help
goat bsky -h
goat help bsky
# etc

Most commands use public APIs and don’t require authentication. Some commands, like creating records, require an atproto account. You can log in using an “app password” with goat account login -u <handle> -p <password>.

WARNING: goat will store both the app password and authentication tokens in the current users home directory, in…