st post

st-post — Post a story to Discourse

Publishes a story to your Discourse forum. Optionally attaches an MP3 audio file. Use --check to verify your credentials without actually posting.

Run after: st-prep · st-fix · st-merge

Examples

st-post subject.json                    # post to Test (cleared daily) — safe default
st-post --category private subject.json # post to your private category
st-post -s 2 subject.json              # post story 2
st-post --site MySite subject.json     # post to a named Discourse site
st-post --check                        # verify credentials without posting

Options: -s story --site --category --fact --check -v -q

Related: st-prep · st-speak · st-admin

---

For developers

Site credentials are read from the DISCOURSE JSON in .env. If an .mp3 file is provided, it is uploaded first and the Discourse audio-player embed syntax is prepended to the post.