Skip to content

st post

b2o2i edited this page Apr 3, 2026 · 7 revisions

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 story 1 to default site
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 --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.

Clone this wiki locally