Service: AT Protocol CLI - EyevinnOSC/community GitHub Wiki

AT Protocol CLI

AT Protocol CLI (GOAT CLI) is a command-line tool for interacting with the AT Protocol, the open protocol behind Bluesky. Running it on OSC gives you a Docker-based environment for AT Protocol operations such as identity resolution and data backup to S3, without needing a local AT Protocol toolchain.

Getting Started

Create an AT Protocol CLI instance at https://app.osaas.io/dashboard/service/birme-goatcli.

Prerequisites

  • An OSC account. Sign up at https://app.osaas.io.
  • An AT Protocol handle or DID to operate on.
  • Optional: AWS credentials if you want to back up data to S3.

Create an Instance

  1. Go to AT Protocol CLI in the OSC dashboard.
  2. Click Create new instance.
  3. Fill in the required fields:
    • name: A name for this CLI job instance.
    • cmdLineArgs: The GOAT CLI command-line arguments to run (for example, resolve did:plc:abc123).
  4. Optionally provide AWS credentials if the command writes output to S3:
    • awsAccessKeyId
    • awsSecretAccessKey
    • awsSessionToken (for temporary credentials)
    • awsRegion
  5. Click Create.

The instance runs the specified command and you can retrieve the output from the logs.

Usage Example

Resolve an AT Protocol identity:

osc create birme-goatcli resolve-identity \
  -o cmdLineArgs="resolve did:plc:ewvi7nxzyoun6zhhandbv9sik"

Back up a Bluesky repo to S3:

osc create birme-goatcli backup-repo \
  -o cmdLineArgs="repo export did:plc:abc123 --output s3://mybucket/backup.car" \
  -o awsAccessKeyId="AKIAIOSFODNN7EXAMPLE" \
  -o awsSecretAccessKey="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \
  -o awsRegion="eu-west-1"

Resources