Commands

Global flags, valid on every command: --json, -q, --quiet, --no-color, --no-input. See Scripting for what each one does.

Auth

postonus login              # sign in via your browser
postonus logout              # remove the stored credentials
postonus whoami               # show the signed-in account

Channels

postonus channels list                              # alias: ls
postonus channels connect [-p, --platform <name>]    # prompts for a platform when omitted
                           [--no-wait]                # return immediately instead of waiting for approval

Two platforms — Bluesky and Telegram — connect with a credential instead of OAuth, so channels connect points you at the dashboard for those instead of opening a browser hop.

Post

postonus post [text]
  -t, --to <platforms>     comma-separated platforms, e.g. x,linkedin
  -a, --at <time>          ISO timestamp to publish at
  -o, --optimal            use the next recommended window
  -d, --draft              save as a draft without scheduling
  -f, --file <path>        read content from a file
  -e, --editor             compose in $EDITOR
  -m, --media <path...>    attach local image or video files
  --dry-run                show what would be scheduled without doing it

text also accepts piped stdin: cat draft.md | postonus post --to x --optimal. Content resolves in this order: --file, then --editor, then the argument, then piped input. Exactly one of --at, --optimal, or --draft is required — post never publishes immediately.

postonus best-times -t, --to <platforms>   # required

Recommended posting windows for the given platforms, computed locally with no network call.

Queue

postonus queue list                          # alias: ls
  -n, --limit <count>       how many to show, 10-100 (default 20)
  -t, --to <platforms>      filter by comma-separated platforms
  -s, --status <statuses>   filter by comma-separated statuses

postonus queue move <scheduleId> -a, --at <time>   # reschedule one queued post

<scheduleId> comes from queue list.

Media

postonus media upload <paths...>

Uploads one or more local image or video files and prints each one's media id and public URL. post --media <path...> uploads the same way before creating the post.