Skip to content
Social Publish Docs

CLI

socialpublish (short: sp) runs Social Publish from your terminal or CI. It is one file with nothing else to install, for Windows, macOS and Linux.

Install

Section titled “Install”
Terminal window
go build -o socialpublish ./cmd/socialpublish

Sign in

Section titled “Sign in”
Terminal window
sp login                 # opens your browser to sign in
sp login --token agp_…   # or use an API token
sp whoami
sp logout

In CI, skip login and set an environment variable instead:

Terminal window
export SOCIALPUBLISH_TOKEN=agp_…

Options on every command

Section titled “Options on every command”
Option Does
--json Machine-readable output for scripts
--workspace <name> Use another workspace for this one command
--base-url <url> Talk to another server (e.g. local)

sp use "Acme Bakery" sets the default workspace. sp workspaces and sp accounts list what you have. sp usage shows this month’s API calls.

When the server refuses something, the CLI prints the server’s own message.