50 lines
1.7 KiB
Groff
50 lines
1.7 KiB
Groff
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.TH am-restart 1 "restart "
|
|
.SH NAME
|
|
restart \- Restart an agent: stop, then start with the same options
|
|
.SH SYNOPSIS
|
|
\fBrestart\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\-\-parallel\fR] [\fB\-\-container\fR] [\fB\-\-force\fR] [\fB\-\-timeout\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
|
.SH DESCRIPTION
|
|
Restart an agent: stop, then start with the same options
|
|
.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\-\-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\-\-force\fR
|
|
Kill immediately instead of terminating gracefully
|
|
.TP
|
|
\fB\-\-timeout\fR \fI<SECS>\fR
|
|
Grace period in seconds before killing (default: from config, 5s)
|
|
.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)
|