Skip to content

stackblaze agent

Without a prompt, starts an interactive chat. With a prompt (positional or --prompt), sends one message, prints the answer and exits.

stackblaze agent [prompt...] [options]
Flag Description
--prompt <text> One-shot prompt (or pass it positionally, not both)
-p, --pipeline <name>, --phase <name>, -a, --app <name> Give the conversation this scope
--json One-shot only: print sessionId, response, toolCalls and model as JSON
--plain Plain text, without the streaming terminal UI
-y, --yes Approve the agent’s destructive actions automatically
--list List saved sessions on this machine
--thread-id <id>, --session-id <id> Resume a saved session

Also accepts --token, --api-url and -o, --output.

-p means --pipeline, as in every other command. Pass the prompt as text: stackblaze agent "why is my app slow?".

Terminal window
stackblaze agent
stackblaze agent "why did my last deploy fail?" -a api
stackblaze agent --json --prompt "list my apps" | jq -r .response
stackblaze agent --list
stackblaze agent --session-id 3f2c…

When the agent wants to take a destructive action, it asks you first. Without a terminal, those requests are declined unless you pass -y. A one-shot run whose turn fails exits 3.

Sessions are saved under ~/.config/stackblaze/.