otty / apps
All apps/Docker Agent

Docker Agent

docker-agent

Agent Builder and Runtime by Docker Engineering

Runs as docker-agent|macOS, Linux, Windows|docs.docker.com
Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 15 fields

Run a Docker Agent configuration interactively or headless. Sandbox, worktree, hook, remote and recording options are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui docker-agent

docker-agent run

Run an agent
Run an agentExample values, fixed in this page — nothing here reaches a terminal
Basic
Agent config
file
Messages
string
Agent name
string
Model override
string
TasksEach one presets the form for one job
Interactive session
configmessagesagentmodel
One-shot headless task
execconfigmessageslast
Validate a config
configdry_run
ParametersOnly these flags are editable in the form
Agent config
A .yaml, .yml or .hcl file; omit to use docker-agent.yaml in the current directory or the built-in agent.
path · positional 0
Messages
Queued in order; each is processed in sequence.
string · positional 1 · repeatable
Non-interactive (headless)
boolean
--exec
Agent name
string
--agent-a
Model override
provider/model, or agent=provider/model.
string
--modelanthropic/claude-sonnet-4-5openai/gpt-4o
Tool approval mode
enum
--safetystrictbalancedrestrictedautonomous
Auto-approve tool calls
boolean
--yolo
Resume session
Session id or relative ref such as -1 for the newest.
string
--session
Extra context files
path · repeatable
--prompt-file
Working directory
path
--working-dir
Only the final answer
Requires headless mode.
boolean
--last
JSON output
boolean
--json
Validate only
boolean
--dry-run
Lean inline TUI
boolean
--lean
Debug logging
boolean
--debug-d
SourcesEvery flag above is checked against these
cli
$ docker agent run [config] [message...] [flags] -a, --agent <name> Run a specific agent from the config --yolo Auto-approve tool calls (unless explicitly denied). Legacy alias for --safety autonomous. --safety <mode> Safety mode for tool approval: strict (ask for everything), balanced (auto-approve safe calls), restricted (auto-approve safe calls, deny the…
help

docker.github.io

Before it fills your prompt, Otty checks the installed docker-agent against its version. A form that does not match your version is not offered.