Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mulerun.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

mulerun session manages AI task sessions on the MuleRun platform — the same sessions you would otherwise drive from the web UI, but scriptable. This page is a quick overview. Detailed per-subcommand pages are coming soon.

​
At a glance

mulerun session run    --prompt "Build a todo app"        # create + chat in one shot
mulerun session create --name "API design" --ttl 3600     # create only
mulerun session list   --limit 10 --status idle           # browse
mulerun session get    <session-id>                       # details
mulerun session prompt <session-id> "Add a delete button" # multi-turn
mulerun session events <session-id> --limit 100           # event log
mulerun session publish <session-id>                      # publish preview
mulerun session delete <session-id>                       # cleanup
Attach local files to any prompt with -f: 
mulerun session run --prompt "Analyze this data" -f data.csv
mulerun session prompt <session-id> "Compare these" -f a.pdf -f b.pdf

​
Common subcommands

CommandWhat it does
session createCreate a new session (no prompt).
session runCreate a session and stream the first prompt.
session listList sessions (filter by status, paginate).
session getShow session details.
session promptSend a follow-up prompt (positional <text>).
session chatSend a follow-up prompt (--prompt flag, file attachments).
session cancelCancel the in-flight operation.
session statusView / update session status.
session eventsTail the event log.
session publishPublish a preview URL.
session renewRenew the sandbox timeout.
session restart-acpRestart the ACP subprocess.
session questionRespond to a Human-in-the-Loop question.
session shareGenerate a shareable link.
session deleteDelete the session.

​
Streaming

Long-running prompts stream their output to stdout as the agent works. Status messages go to stderr; press Ctrl+C to cancel cleanly (the CLI sends an explicit session/cancel over the WebSocket). For machine consumption use -o json or -o jsonl.

​
Tips

  • session run is the fastest way from zero to a streaming response.
  • Once a session exists, prefer session prompt (positional text) for shell-friendly one-liners and session chat (--prompt) when you also need to attach files.
  • Combine with mulerun page to publish the output of a session as a deployed page.