CLI

fopost is the official command-line interface. It is a single static binary with no runtime to install, and every command speaks to the API through the Go SDK: the CLI adds the flags, tables, and exit codes, and nothing else.

Source and issues: github.com/fopost/fopost-cli. MIT licensed.

Install

brew install fopost/tap/fopost

go install github.com/fopost/fopost-cli@latest

go install produces a binary named fopost-cli, because Go names it after the module. Rename it once if you want the short name:

mv "$(go env GOPATH)/bin/fopost-cli" "$(go env GOPATH)/bin/fopost"

Or take the archive for your platform from the releases page, verify it against checksums.txt, and put fopost on your PATH:

tar -xzf fopost_0.1.0_darwin_arm64.tar.gz
sudo mv fopost /usr/local/bin/
fopost version

Prebuilt binaries cover macOS, Linux, and Windows on both amd64 and arm64. Building from source needs Go 1.22 or newer.

Authenticate

Create a key at Settings → API Keys in the dashboard, then:

fopost auth login
# API key: (input is hidden)

fopost auth status     # which key is in effect, and where it came from
fopost auth logout     # remove it

The key is stored at ~/.config/fopost/config.json with mode 0600, and $XDG_CONFIG_HOME is honoured. It is never printed back: auth status shows only a masked prefix, and verbose output never contains it. auth logout --all also clears the saved workspace and base URL, and auth status exits non-zero when no key resolves, so a script can use it as an "am I signed in?" check.

Three sources, in order of precedence:

In CI, set FOPOST_API_KEY as a secret and skip auth login entirely.

fopost auth login --workspace ws_123 saves a default workspace, so workspace-scoped commands need no --workspace flag. With exactly one reachable workspace, login picks it for you. There is no environment variable for the workspace: it comes from the --workspace flag or the saved default only.

Global flags

Accepted on every command:

--timeout is per request, and the SDK retries up to three times underneath, so one command can take longer than the timeout you set.

Commands

fopost auth          login · status · logout
fopost workspaces    list · get · create
fopost accounts      list · get · health · validate · refresh
fopost posts         list · get · create · publish · cancel · delete
                     duplicate · preflight · deliveries
fopost media         list · upload · delete
fopost labels        list · create · delete
fopost analytics     overview · top-posts · time-series
fopost automations   list · get · toggle · trigger · runs
fopost webhooks      list · create · test · delete
fopost completion    bash · zsh · fish · powershell
fopost version

posts, accounts, workspaces, labels, automations, and webhooks also answer to their singular forms, and workspaces to ws. Run fopost <command> --help for the flags on any of them, or read the pages below.

Retries and rate limits

Handled by the SDK, not the CLI: three attempts per request, exponential backoff, retrying only 429, 5xx, and network failures, and honouring Retry-After. When the retries are exhausted the CLI prints the reason and exits 7 or 9, so a script can back off on its own terms. The exit codes map each API failure to a distinct code.

Next