.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH am-start 1  "start " 
.SH NAME
start \- Start an agent (foreground by default, or detached with \-\-background)
.SH SYNOPSIS
\fBstart\fR [\fB\-b\fR|\fB\-\-background\fR] [\fB\-f\fR|\fB\-\-foreground\fR] [\fB\-\-args\fR] [\fB\-\-env\fR] [\fB\-\-notify\fR] [\fB\-\-profile\fR] [\fB\-\-model\fR] [\fB\-\-provider\fR] [\fB\-\-no\-sandbox\fR] [\fB\-\-parallel\fR] [\fB\-\-container\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR] 
.SH DESCRIPTION
Start an agent (foreground by default, or detached with \-\-background)
.SH OPTIONS
.TP
\fB\-b\fR, \fB\-\-background\fR
Run detached in the background; output goes to the agent log file
.TP
\fB\-f\fR, \fB\-\-foreground\fR
Run in the foreground, attached to this terminal (the default)
.TP
\fB\-\-args\fR [\fI<ARGS>...\fR]
Extra arguments passed to the agent (repeatable; quoted strings are split on spaces)
.TP
\fB\-\-env\fR \fI<KEY=VALUE>\fR
Set an environment variable for the agent (repeatable): \-\-env KEY=VALUE
.TP
\fB\-\-notify\fR
Send a desktop notification once the agent has started
.TP
\fB\-\-profile\fR \fI<NAME>\fR
Apply an environment profile (env + args, defined in the config)
.TP
\fB\-\-model\fR \fI<MODEL>\fR
Local model to use for this run (validated against the local runtimes)
.TP
\fB\-\-provider\fR \fI<PROVIDER>\fR
Provider to use for this run (issue #92): resolved from the registry
.TP
\fB\-\-no\-sandbox\fR
Skip the agent\*(Aqs sandbox profile for this run (issue #79)
.TP
\fB\-\-parallel\fR
Start every member of a group simultaneously (issue #57)
.TP
\fB\-\-container\fR
Run the agent inside a container (issue #58)
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIAGENT\fR]
Agent name, alias, or group:<name> (defaults to the project\*(Aqs default agent)