Scripting

The CLI is built to sit inside scripts: structured output on stdout, errors on stderr, and a distinct exit code per failure class.

--json

Every command takes --json and prints the resource instead of a table, so it composes with jq:

# Every account whose credentials have gone stale.
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id'

# Re-validate each of them, stopping at the first hard failure.
fopost accounts health --json \
  | jq -r '.accounts[] | select(.healthStatus != "healthy") | .id' \
  | xargs -I{} fopost accounts validate {} --quiet

# The id of the post you just created, for the next step in a pipeline.
POST_ID=$(fopost posts create --account acc_1 --text "..." --draft --json | jq -r '.post.id')
fopost posts publish "$POST_ID" --json | jq '.deliveries[] | {accountId, status}'

--quiet silences the human-facing output while keeping the exit code, and --json still prints under --quiet: the machine output is not chatter. Colour is dropped when NO_COLOR is set, when --no-color is passed, or when output is not a terminal.

Two shape notes worth knowing before writing jq:

• posts list --all prints a bare array; a paged posts list prints the page envelope ({"data": [...], "meta": {...}})
• posts create --json wraps its pieces: {"post": {...}, "media": [...], "publish": {...}}, with the optional keys present only when they happened

Exit codes

Errors print one line to stderr, never to stdout, so a failed run never contaminates a pipe. Confirmation prompts also live on stderr and read stdin, so a non-interactive delete without --yes fails fast instead of hanging.

CI

Set FOPOST_API_KEY as a secret and pass --workspace explicitly. There is no environment variable for the workspace, and CI has no saved config:

FOPOST_API_KEY=$FOPOST_API_KEY fopost posts create \
  --workspace "$WORKSPACE_ID" \
  --account "$ACCOUNT_ID" \
  --text-file release-notes.md \
  --publish --json --quiet

For GitHub specifically, the GitHub Action wraps this pattern.

Shell completion

source <(fopost completion bash)   # ~/.bashrc
source <(fopost completion zsh)    # ~/.zshrc, with compinit running
fopost completion fish | source
fopost completion powershell | Out-String | Invoke-Expression

To install it permanently instead of per shell:

fopost completion zsh > "${fpath[1]}/_fopost"
fopost completion bash > /etc/bash_completion.d/fopost

Homebrew installs completions for you.

Next