Session

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

Command	What it does
`session create`	Create a new session (no prompt).
`session run`	Create a session and stream the first prompt.
`session list`	List sessions (filter by status, paginate).
`session get`	Show session details.
`session prompt`	Send a follow-up prompt (positional `<text>`).
`session chat`	Send a follow-up prompt (`--prompt` flag, file attachments).
`session cancel`	Cancel the in-flight operation.
`session status`	View / update session status.
`session events`	Tail the event log.
`session publish`	Publish a preview URL.
`session renew`	Renew the sandbox timeout.
`session restart-acp`	Restart the ACP subprocess.
`session question`	Respond to a Human-in-the-Loop question.
`session share`	Generate a shareable link.
`session delete`	Delete 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.

Getting Started

Commands

Reference

At a glance

Common subcommands

Streaming

Tips

​At a glance

​Common subcommands

​Streaming

​Tips

At a glance

Common subcommands

Streaming

Tips