--at sets when a post goes out. Without it, it publishes now.
Times
--at | Means |
|---|---|
2026-10-05T09:00:00Z | That moment |
"tomorrow 9am" | 9:00 tomorrow |
"in 2 hours" | Two hours from now |
"fri 17:30" | Coming Friday, 17:30 |
"next monday 8:00" | Monday next week, 8:00 |
statuz posts create --text "Office hours in 10 minutes" --to mastodon --at "fri 14:50"Time zones
Words use your computer's zone. Override per post or for all:
statuz posts create --text "Good morning, Lisbon" --to x --at "tomorrow 8am" --timezone Europe/Lisbon
statuz config set --key timezone --value America/Sao_PauloIANA names only. Posts are stored in UTC, so changing the setting doesn't move scheduled posts.
Threads
One --text per post, up to 25:
statuz posts create --to bluesky --at "tomorrow 10am" \
--text "1/ What we changed in v2" \
--text "2/ One CLI for every platform" \
--text "3/ Agents can drive it directly"- Each post is checked against every destination's limit before saving. On Cloud, a photo over a size limit is shrunk for that platform instead.
--mediaattaches to the first post. For media on later posts, pass the thread as JSON with--input(CLI reference).- A post without media that has a link gets a link card (title, description, image) on Bluesky and LinkedIn. When the link ends the post, they get the card without the URL in the text, as their own composers do. X and Mastodon make their own cards.
--link <url>sets the first post's card, and the card stays even when the text doesn't have the URL. X and Mastodon get the URL at the end of the text, so they show their card too.--link ""posts without a card. In the Mac app and on statuz.cloud, delete the URL and keep the card, or remove the card with its ×.
A Reddit post needs a title. Without --subreddit it goes to your profile.
statuz posts create --to reddit --subreddit IndieDev --title "What we shipped" --text "The long version."
statuz accounts flairs --to u/you --subreddit IndieDev- Before saving, Statuz checks the subreddit's own rules: a required flair, how long a title can be.
--flairtakes an id fromaccounts flairs.--nsfwand--spoilermark the post.- The title is Reddit's. With
--title-first, X, Bluesky, Mastodon and LinkedIn open with it too: the title, a blank line, then the text. - Two to 20 images make a gallery. A gallery has no text, only its title.
- A post Reddit can't take (no title, a photo with a caption) skips your default Reddit account and goes everywhere else. With
--to redditit fails and says why. - A thread goes out as one post.
Drafts
statuz posts create --text "Idea for later" --draft
statuz posts edit --id <id> --no-draft --at "mon 9am"
statuz posts publish --id <id>Drafts never publish on their own. In the Mac app and on statuz.cloud they sit in the Queue's week view with your scheduled posts.
Queue
statuz posts list --status scheduled
statuz posts list --from today --until "next monday"In the Mac app and on statuz.cloud, the Queue has a search field: type a few words and only the posts with all of them stay.
Edit, move, delete
statuz posts edit --id p_k3m9x2abqe --at "fri 10:00"
statuz posts edit --id p_k3m9x2abqe --text "Fixed typo"
statuz posts delete --id p_k3m9x2abqe
statuz posts delete --id p_k3m9x2abqe --keep-on-platforms- Passed fields replace the old ones. Published posts can't be edited.
--atin the past publishes on the next check.- Delete takes a published post down from every platform it went out to, the whole thread, then removes it from Statuz.
- If a platform refuses, the post stays in Statuz with only that copy. Delete again to retry.
--keep-on-platformsonly removes it from Statuz.
Missed posts
Locally, the daemon (statuz start) publishes. If your computer is off or asleep at post time:
- Back within 60 minutes: it goes out late.
- Later: marked missed. It waits for you.
statuz posts publish --id p_k3m9x2abqe
statuz posts edit --id p_k3m9x2abqe --at "tomorrow 9am"Statuz Cloud publishes on time either way.
Failed posts
- One failing destination doesn't stop the others.
- Network errors and rate limits retry with backoff.
statuz posts get --id <id>shows each destination's result.statuz posts publish --id <id>retries only what failed. Nothing posts twice.