st new

st-new — Start a new report from a prompt template

Creates a fresh prompt file from a template and opens your editor so you can fill in the topic. The starting point for every new research report.

Run before: st-gen · st-bang

Examples

st-new subject                          # create prompt, open editor
st-new -g subject                       # create, edit, then run st-gen + st-prep automatically
st-new -g --agent gemini subject           # same, using a specific AI provider
st-new --template custom subject        # use a named template
st-new --bang subject                   # edit then run st-bang (all AIs)

Options: --template -g/--gen --agent --bang --st --no-spell -v -q

Related: st-gen · st-bang · st-admin

---

For developers

Template resolution order: ./template/ (CWD) → ~/.cross_templates/ → <script-dir>/template/. After editing, optionally launches st-bang automatically. st-admin --init-templates seeds ~/.cross_templates/ for pip/pipx installs.