v0.4.1 : Phase 1 complete (17/17) - dashboard TUI (#33), favoris/notes/tags (#39), profils d'environnement (#40), completions dynamiques + man pages (#41), packaging officiel + CI (#42), self-update Gitea, state v3, 212 tests
This commit is contained in:
@@ -0,0 +1,26 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-alias 1 "alias "
|
||||
.SH NAME
|
||||
alias \- Manage command aliases (cc \-> claude\-code)
|
||||
.SH SYNOPSIS
|
||||
\fBalias\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
|
||||
.SH DESCRIPTION
|
||||
Manage command aliases (cc \-> claude\-code)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.SH SUBCOMMANDS
|
||||
.TP
|
||||
alias\-add(1)
|
||||
Add an alias (am alias add cc claude\-code)
|
||||
.TP
|
||||
alias\-remove(1)
|
||||
Remove an alias
|
||||
.TP
|
||||
alias\-list(1)
|
||||
List every alias
|
||||
.TP
|
||||
alias\-help(1)
|
||||
Print this message or the help of the given subcommand(s)
|
||||
@@ -0,0 +1,35 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-completion 1 "completion "
|
||||
.SH NAME
|
||||
completion \- Generate a shell completion script
|
||||
.SH SYNOPSIS
|
||||
\fBcompletion\fR [\fB\-\-installed\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fISHELL\fR>
|
||||
.SH DESCRIPTION
|
||||
Generate a shell completion script
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-installed\fR
|
||||
Add dynamic completion of the installed agents, aliases and groups (queried from \*(Aqam _agents\*(Aq at Tab time)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fISHELL\fR>
|
||||
Shell to generate completions for
|
||||
.br
|
||||
|
||||
.br
|
||||
\fIPossible values:\fR
|
||||
.RS 14
|
||||
.IP \(bu 2
|
||||
bash
|
||||
.IP \(bu 2
|
||||
elvish
|
||||
.IP \(bu 2
|
||||
fish
|
||||
.IP \(bu 2
|
||||
powershell
|
||||
.IP \(bu 2
|
||||
zsh
|
||||
.RE
|
||||
@@ -0,0 +1,35 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-config 1 "config "
|
||||
.SH NAME
|
||||
config \- Manage the configuration file
|
||||
.SH SYNOPSIS
|
||||
\fBconfig\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
|
||||
.SH DESCRIPTION
|
||||
Manage the configuration file
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.SH SUBCOMMANDS
|
||||
.TP
|
||||
config\-show(1)
|
||||
Print the effective (merged) configuration as YAML
|
||||
.TP
|
||||
config\-path(1)
|
||||
Print the location of the configuration file(s)
|
||||
.TP
|
||||
config\-edit(1)
|
||||
Open the user configuration file in your editor
|
||||
.TP
|
||||
config\-validate(1)
|
||||
Validate the configuration file(s)
|
||||
.TP
|
||||
config\-add(1)
|
||||
Add another agent definition file to the user configuration
|
||||
.TP
|
||||
config\-set(1)
|
||||
Set one configuration key without an editor (config set settings.default_shell pwsh)
|
||||
.TP
|
||||
config\-help(1)
|
||||
Print this message or the help of the given subcommand(s)
|
||||
@@ -0,0 +1,13 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-dashboard 1 "dashboard "
|
||||
.SH NAME
|
||||
dashboard \- Live TUI dashboard: overview, activity, stats, sessions, projects
|
||||
.SH SYNOPSIS
|
||||
\fBdashboard\fR [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Live TUI dashboard: overview, activity, stats, sessions, projects
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-doctor 1 "doctor "
|
||||
.SH NAME
|
||||
doctor \- Check the environment: tools, config validity, paths, permissions
|
||||
.SH SYNOPSIS
|
||||
\fBdoctor\fR [\fB\-\-fix\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Check the environment: tools, config validity, paths, permissions
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-fix\fR
|
||||
Attempt to repair problems (create directories, fix the state file)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-export 1 "export "
|
||||
.SH NAME
|
||||
export \- Export the configuration and installation state (backup)
|
||||
.SH SYNOPSIS
|
||||
\fBexport\fR [\fB\-\-output\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Export the configuration and installation state (backup)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-output\fR \fI<FILE>\fR [default: am\-export.json]
|
||||
Output file (default: am\-export.json)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-favorite 1 "favorite "
|
||||
.SH NAME
|
||||
favorite \- Mark an agent as a favorite (star in list and status)
|
||||
.SH SYNOPSIS
|
||||
\fBfavorite\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Mark an agent as a favorite (star in list and status)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-help 1 "help "
|
||||
.SH NAME
|
||||
help \- Display help: the overview, a command, the command list, or a search
|
||||
.SH SYNOPSIS
|
||||
\fBhelp\fR [\fB\-\-find\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fICOMMAND\fR]
|
||||
.SH DESCRIPTION
|
||||
Display help: the overview, a command, the command list, or a search
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-find\fR \fI<TEXT>\fR
|
||||
Search through all help commands table
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fICOMMAND\fR]
|
||||
Command name (also accepts an agent name or alias); "commands" lists every command
|
||||
@@ -0,0 +1,34 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-history 1 "history "
|
||||
.SH NAME
|
||||
history \- Search the command history (am and shell commands)
|
||||
.SH SYNOPSIS
|
||||
\fBhistory\fR [\fB\-\-kind\fR] [\fB\-\-cwd\fR] [\fB\-\-search\fR] [\fB\-\-failed\fR] [\fB\-\-session\fR] [\fB\-\-limit\fR] [\fB\-\-rerun\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Search the command history (am and shell commands)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-kind\fR \fI<KIND>\fR
|
||||
Only commands of this kind (am or shell)
|
||||
.TP
|
||||
\fB\-\-cwd\fR \fI<DIR>\fR
|
||||
Only commands run in this directory
|
||||
.TP
|
||||
\fB\-\-search\fR \fI<TEXT>\fR
|
||||
Full\-text search in the command line
|
||||
.TP
|
||||
\fB\-\-failed\fR
|
||||
Only failed commands
|
||||
.TP
|
||||
\fB\-\-session\fR \fI<ID>\fR
|
||||
Only commands of this session
|
||||
.TP
|
||||
\fB\-\-limit\fR \fI<N>\fR [default: 100]
|
||||
Maximum number of entries (default: 100)
|
||||
.TP
|
||||
\fB\-\-rerun\fR \fI<N>\fR
|
||||
Re\-run the Nth most recent entry (with confirmation)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-import 1 "import "
|
||||
.SH NAME
|
||||
import \- Import a previously exported configuration and state
|
||||
.SH SYNOPSIS
|
||||
\fBimport\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIFILE\fR>
|
||||
.SH DESCRIPTION
|
||||
Import a previously exported configuration and state
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIFILE\fR>
|
||||
File exported by the export command
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-info 1 "info "
|
||||
.SH NAME
|
||||
info \- Show detailed information about one agent
|
||||
.SH SYNOPSIS
|
||||
\fBinfo\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Show detailed information about one agent
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-init 1 "init "
|
||||
.SH NAME
|
||||
init \- Generate a local agent\-manager.yaml for the current directory
|
||||
.SH SYNOPSIS
|
||||
\fBinit\fR [\fB\-\-force\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Generate a local agent\-manager.yaml for the current directory
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-force\fR
|
||||
Overwrite an existing agent\-manager.yaml
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,22 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-install 1 "install "
|
||||
.SH NAME
|
||||
install \- Install an agent and its dependencies
|
||||
.SH SYNOPSIS
|
||||
\fBinstall\fR [\fB\-\-method\fR] [\fB\-\-force\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Install an agent and its dependencies
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-method\fR \fI<METHOD>\fR
|
||||
Select the install method (index, or type: npm, pip, uv, cargo, go, bun, curl, binary, git)
|
||||
.TP
|
||||
\fB\-\-force\fR
|
||||
Reinstall even if already installed
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,25 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-list 1 "list "
|
||||
.SH NAME
|
||||
list \- List installed agents (default); use \-\-all for the whole catalog
|
||||
.SH SYNOPSIS
|
||||
\fBlist\fR [\fB\-\-all\fR] [\fB\-\-category\fR] [\fB\-\-running\fR] [\fB\-\-sort\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
List installed agents (default); use \-\-all for the whole catalog
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-all\fR
|
||||
Show every agent known to the catalog, not only the installed ones
|
||||
.TP
|
||||
\fB\-\-category\fR \fI<CATEGORY>\fR
|
||||
Only show agents of this category
|
||||
.TP
|
||||
\fB\-\-running\fR
|
||||
Only show running agents
|
||||
.TP
|
||||
\fB\-\-sort\fR \fI<KEY>\fR
|
||||
Sort by name, version or status (default: name)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,28 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-log 1 "log "
|
||||
.SH NAME
|
||||
log \- Read the event journal: everything am did
|
||||
.SH SYNOPSIS
|
||||
\fBlog\fR [\fB\-\-kind\fR] [\fB\-\-since\fR] [\fB\-\-limit\fR] [\fB\-\-follow\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
||||
.SH DESCRIPTION
|
||||
Read the event journal: everything am did
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-kind\fR \fI<KINDS>\fR
|
||||
Only these event kinds (comma separated: start,stop,run,install,...)
|
||||
.TP
|
||||
\fB\-\-since\fR \fI<DATE>\fR
|
||||
Only events at or after this date (YYYY\-MM\-DD or RFC 3339)
|
||||
.TP
|
||||
\fB\-\-limit\fR \fI<N>\fR [default: 50]
|
||||
Maximum number of events (default: 50)
|
||||
.TP
|
||||
\fB\-\-follow\fR
|
||||
Follow the journal as new events arrive
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Only events of this agent
|
||||
@@ -0,0 +1,22 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-logs 1 "logs "
|
||||
.SH NAME
|
||||
logs \- Tail the log file of an agent (\-\-follow for a live view)
|
||||
.SH SYNOPSIS
|
||||
\fBlogs\fR [\fB\-\-lines\fR] [\fB\-\-follow\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Tail the log file of an agent (\-\-follow for a live view)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-lines\fR \fI<N>\fR [default: 20]
|
||||
Number of lines to show (default: 20)
|
||||
.TP
|
||||
\fB\-\-follow\fR
|
||||
Follow the log as it grows
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-man 1 "man "
|
||||
.SH NAME
|
||||
man \- Generate a man page for am (or for one command)
|
||||
.SH SYNOPSIS
|
||||
\fBman\fR [\fB\-\-output\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fICOMMAND\fR]
|
||||
.SH DESCRIPTION
|
||||
Generate a man page for am (or for one command)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-output\fR \fI<DIR>\fR
|
||||
Write the page(s) to this directory instead of stdout
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fICOMMAND\fR]
|
||||
Command name (omit for the whole CLI)
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-note 1 "note "
|
||||
.SH NAME
|
||||
note \- Attach a free\-form note to an agent (shown in \*(Aqam info\*(Aq); \*(Aqam note <agent>\*(Aq without text prints the current note
|
||||
.SH SYNOPSIS
|
||||
\fBnote\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR> [\fITEXT...\fR]
|
||||
.SH DESCRIPTION
|
||||
Attach a free\-form note to an agent (shown in \*(Aqam info\*(Aq); \*(Aqam note <agent>\*(Aq without text prints the current note
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
.TP
|
||||
[\fITEXT...\fR]
|
||||
Note text (several words are joined); empty prints the note
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-open 1 "open "
|
||||
.SH NAME
|
||||
open \- Open an agent\*(Aqs installation directory in the file manager
|
||||
.SH SYNOPSIS
|
||||
\fBopen\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Open an agent\*(Aqs installation directory in the file manager
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,23 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-profile 1 "profile "
|
||||
.SH NAME
|
||||
profile \- Manage environment profiles (dev, prod, ...)
|
||||
.SH SYNOPSIS
|
||||
\fBprofile\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
|
||||
.SH DESCRIPTION
|
||||
Manage environment profiles (dev, prod, ...)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.SH SUBCOMMANDS
|
||||
.TP
|
||||
profile\-list(1)
|
||||
List every defined profile
|
||||
.TP
|
||||
profile\-show(1)
|
||||
Show one profile in detail (agent, env, args)
|
||||
.TP
|
||||
profile\-help(1)
|
||||
Print this message or the help of the given subcommand(s)
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-projects 1 "projects "
|
||||
.SH NAME
|
||||
projects \- Show which agent works on which project
|
||||
.SH SYNOPSIS
|
||||
\fBprojects\fR [\fB\-h\fR|\fB\-\-help\fR] [\fINAME\fR]
|
||||
.SH DESCRIPTION
|
||||
Show which agent works on which project
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fINAME\fR]
|
||||
Project name (omit to list every project)
|
||||
@@ -0,0 +1,22 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-report 1 "report "
|
||||
.SH NAME
|
||||
report \- Write a markdown activity report
|
||||
.SH SYNOPSIS
|
||||
\fBreport\fR [\fB\-\-last\-week\fR] [\fB\-\-last\-month\fR] [\fB\-\-output\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Write a markdown activity report
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-last\-week\fR
|
||||
Cover the last 7 days
|
||||
.TP
|
||||
\fB\-\-last\-month\fR
|
||||
Cover the last 30 days
|
||||
.TP
|
||||
\fB\-\-output\fR \fI<FILE>\fR
|
||||
Output file (default: report\-YYYYMMDD.md in the state directory)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,40 @@
|
||||
.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\-\-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\-\-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)
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-run 1 "run "
|
||||
.SH NAME
|
||||
run \- Run the agent command directly with the given arguments (no process management)
|
||||
.SH SYNOPSIS
|
||||
\fBrun\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR> [\fIARGS...\fR]
|
||||
.SH DESCRIPTION
|
||||
Run the agent command directly with the given arguments (no process management)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
.TP
|
||||
[\fIARGS...\fR]
|
||||
Arguments passed through to the agent command
|
||||
@@ -0,0 +1,22 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-search 1 "search "
|
||||
.SH NAME
|
||||
search \- Search the catalog by keyword (name, description, category, tags)
|
||||
.SH SYNOPSIS
|
||||
\fBsearch\fR [\fB\-\-category\fR] [\fB\-\-tag\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIKEYWORD\fR]
|
||||
.SH DESCRIPTION
|
||||
Search the catalog by keyword (name, description, category, tags)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-category\fR \fI<CATEGORY>\fR
|
||||
Restrict to this category
|
||||
.TP
|
||||
\fB\-\-tag\fR \fI<TAG>\fR
|
||||
Only agents carrying this personal tag
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIKEYWORD\fR]
|
||||
Keyword to search for (case\-insensitive substring)
|
||||
@@ -0,0 +1,26 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-secret 1 "secret "
|
||||
.SH NAME
|
||||
secret \- Manage secrets in the OS keyring (never in plaintext config)
|
||||
.SH SYNOPSIS
|
||||
\fBsecret\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIsubcommands\fR>
|
||||
.SH DESCRIPTION
|
||||
Manage secrets in the OS keyring (never in plaintext config)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.SH SUBCOMMANDS
|
||||
.TP
|
||||
secret\-set(1)
|
||||
Store a secret for an agent
|
||||
.TP
|
||||
secret\-unset(1)
|
||||
Remove a secret
|
||||
.TP
|
||||
secret\-list(1)
|
||||
List stored secret names (values are never shown)
|
||||
.TP
|
||||
secret\-help(1)
|
||||
Print this message or the help of the given subcommand(s)
|
||||
@@ -0,0 +1,15 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-self-uninstall 1 "self-uninstall "
|
||||
.SH NAME
|
||||
self\-uninstall \- Remove agent\-manager and everything it created from this machine
|
||||
.SH SYNOPSIS
|
||||
\fBself\-uninstall\fR [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Remove agent\-manager and everything it created from this machine
|
||||
.PP
|
||||
Stops every managed background agent, then deletes the data, state and configuration directories, and finally the executable itself. Combine with \-\-yes for a fully automated one\-liner.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help (see a summary with \*(Aq\-h\*(Aq)
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-self-update 1 "self-update "
|
||||
.SH NAME
|
||||
self\-update \- Update agent\-manager itself from GitHub Releases
|
||||
.SH SYNOPSIS
|
||||
\fBself\-update\fR [\fB\-\-check\fR] [\fB\-\-to\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Update agent\-manager itself from GitHub Releases
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-check\fR
|
||||
Only check whether a newer version exists
|
||||
.TP
|
||||
\fB\-\-to\fR \fI<FILE>\fR
|
||||
Download the new binary to this path instead of replacing the current one
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,28 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-sessions 1 "sessions "
|
||||
.SH NAME
|
||||
sessions \- List the sessions of every agent (and of the interactive shell)
|
||||
.SH SYNOPSIS
|
||||
\fBsessions\fR [\fB\-\-project\fR] [\fB\-\-status\fR] [\fB\-\-show\fR] [\fB\-\-resume\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
||||
.SH DESCRIPTION
|
||||
List the sessions of every agent (and of the interactive shell)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-project\fR \fI<PROJECT>\fR
|
||||
Only sessions of this project
|
||||
.TP
|
||||
\fB\-\-status\fR \fI<STATUS>\fR
|
||||
Only sessions with this status (running, stopped, failed, interrupted)
|
||||
.TP
|
||||
\fB\-\-show\fR \fI<ID>\fR
|
||||
Show one session in detail (summary + log excerpt)
|
||||
.TP
|
||||
\fB\-\-resume\fR \fI<ID>\fR
|
||||
Resume a finished session: relaunch the agent with its recorded arguments
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Only sessions of this agent
|
||||
@@ -0,0 +1,34 @@
|
||||
.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\-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\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Agent name, alias, or group:<name> (defaults to the project\*(Aqs default agent)
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-stats 1 "stats "
|
||||
.SH NAME
|
||||
stats \- Show usage statistics computed from the event journal
|
||||
.SH SYNOPSIS
|
||||
\fBstats\fR [\fB\-\-period\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
||||
.SH DESCRIPTION
|
||||
Show usage statistics computed from the event journal
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-period\fR \fI<PERIOD>\fR
|
||||
Only events of the last period (7d, 30d, 90d, all)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Agent name or alias (omit for the global view)
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-status 1 "status "
|
||||
.SH NAME
|
||||
status \- Show the state of one agent, or of every installed agent
|
||||
.SH SYNOPSIS
|
||||
\fBstatus\fR [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
||||
.SH DESCRIPTION
|
||||
Show the state of one agent, or of every installed agent
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Agent name or alias (omit to show all installed agents)
|
||||
@@ -0,0 +1,22 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-stop 1 "stop "
|
||||
.SH NAME
|
||||
stop \- Stop a background agent (SIGTERM, then SIGKILL after the timeout)
|
||||
.SH SYNOPSIS
|
||||
\fBstop\fR [\fB\-\-force\fR] [\fB\-\-timeout\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Stop a background agent (SIGTERM, then SIGKILL after the timeout)
|
||||
.SH OPTIONS
|
||||
.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>
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-tag 1 "tag "
|
||||
.SH NAME
|
||||
tag \- Add a personal tag to an agent
|
||||
.SH SYNOPSIS
|
||||
\fBtag\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR> <\fITAG\fR>
|
||||
.SH DESCRIPTION
|
||||
Add a personal tag to an agent
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
.TP
|
||||
<\fITAG\fR>
|
||||
One or more tags to add
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-tags 1 "tags "
|
||||
.SH NAME
|
||||
tags \- List personal tags (with counts), optionally for one agent
|
||||
.SH SYNOPSIS
|
||||
\fBtags\fR [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
||||
.SH DESCRIPTION
|
||||
List personal tags (with counts), optionally for one agent
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Only show the tags of this agent
|
||||
@@ -0,0 +1,25 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-timeline 1 "timeline "
|
||||
.SH NAME
|
||||
timeline \- One chronological view of every activity (journal + REPL history)
|
||||
.SH SYNOPSIS
|
||||
\fBtimeline\fR [\fB\-\-project\fR] [\fB\-\-since\fR] [\fB\-\-limit\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
||||
.SH DESCRIPTION
|
||||
One chronological view of every activity (journal + REPL history)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-project\fR \fI<PROJECT>\fR
|
||||
Only activity of this project
|
||||
.TP
|
||||
\fB\-\-since\fR \fI<DATE>\fR
|
||||
Only activity at or after this date (YYYY\-MM\-DD or RFC 3339)
|
||||
.TP
|
||||
\fB\-\-limit\fR \fI<N>\fR [default: 50]
|
||||
Maximum number of entries (default: 50)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Only activity of this agent
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-top 1 "top "
|
||||
.SH NAME
|
||||
top \- Show the most used agents (top 10)
|
||||
.SH SYNOPSIS
|
||||
\fBtop\fR [\fB\-\-period\fR] [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Show the most used agents (top 10)
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-period\fR \fI<PERIOD>\fR
|
||||
Only events of the last period (7d, 30d, 90d, all)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,16 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-unfavorite 1 "unfavorite "
|
||||
.SH NAME
|
||||
unfavorite \- Remove the favorite star from an agent
|
||||
.SH SYNOPSIS
|
||||
\fBunfavorite\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Remove the favorite star from an agent
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-uninstall 1 "uninstall "
|
||||
.SH NAME
|
||||
uninstall \- Uninstall an agent (managed or external) and clean its files
|
||||
.SH SYNOPSIS
|
||||
\fBuninstall\fR [\fB\-\-purge\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Uninstall an agent (managed or external) and clean its files
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-purge\fR
|
||||
Also remove logs and the agent entry from the user config file
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-untag 1 "untag "
|
||||
.SH NAME
|
||||
untag \- Remove a personal tag from an agent
|
||||
.SH SYNOPSIS
|
||||
\fBuntag\fR [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR> <\fITAG\fR>
|
||||
.SH DESCRIPTION
|
||||
Remove a personal tag from an agent
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
.TP
|
||||
<\fITAG\fR>
|
||||
Tag to remove
|
||||
@@ -0,0 +1,19 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-update 1 "update "
|
||||
.SH NAME
|
||||
update \- Update an installed agent to the latest available version
|
||||
.SH SYNOPSIS
|
||||
\fBupdate\fR [\fB\-\-all\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIAGENT\fR]
|
||||
.SH DESCRIPTION
|
||||
Update an installed agent to the latest available version
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-all\fR
|
||||
Update every installed managed agent
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
[\fIAGENT\fR]
|
||||
Agent name or alias (required unless \-\-all)
|
||||
@@ -0,0 +1,13 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-version 1 "version "
|
||||
.SH NAME
|
||||
version \- Display version and build information
|
||||
.SH SYNOPSIS
|
||||
\fBversion\fR [\fB\-h\fR|\fB\-\-help\fR]
|
||||
.SH DESCRIPTION
|
||||
Display version and build information
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
@@ -0,0 +1,25 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am-watch 1 "watch "
|
||||
.SH NAME
|
||||
watch \- Supervise an agent and optionally restart it on crash
|
||||
.SH SYNOPSIS
|
||||
\fBwatch\fR [\fB\-\-restart\fR] [\fB\-\-notify\fR] [\fB\-\-interval\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIAGENT\fR>
|
||||
.SH DESCRIPTION
|
||||
Supervise an agent and optionally restart it on crash
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-\-restart\fR
|
||||
Restart the agent automatically when it dies (with backoff)
|
||||
.TP
|
||||
\fB\-\-notify\fR
|
||||
Desktop notification on every restart
|
||||
.TP
|
||||
\fB\-\-interval\fR \fI<SECS>\fR [default: 5]
|
||||
Check interval in seconds (default: 5)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help
|
||||
.TP
|
||||
<\fIAGENT\fR>
|
||||
Agent name or alias
|
||||
@@ -0,0 +1,177 @@
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.TH am 1 "am 0.4.1"
|
||||
.SH NAME
|
||||
am \- agent\-manager (am) — manage local AI coding agents
|
||||
.SH SYNOPSIS
|
||||
\fBam\fR [\fB\-c\fR|\fB\-\-config\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-y\fR|\fB\-\-yes\fR] [\fB\-\-dry\-run\fR] [\fB\-\-json\fR] [\fB\-\-no\-color\fR] [\fB\-\-theme\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIsubcommands\fR]
|
||||
.SH DESCRIPTION
|
||||
agent\-manager (am) — a CLI to manage local AI coding agents.
|
||||
.PP
|
||||
Install, uninstall, start, stop, restart and update AI agents from a YAML
|
||||
catalog. Handles dependencies (Node, Python, Go, Rust, Bun), binaries from
|
||||
GitHub Releases, install scripts, and git repositories. All state lives under
|
||||
your user directories; nothing pollutes the system.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
\fB\-c\fR, \fB\-\-config\fR \fI<FILE>\fR
|
||||
Use an alternate configuration file
|
||||
.TP
|
||||
\fB\-v\fR, \fB\-\-verbose\fR
|
||||
Verbose output: show every command executed and its details
|
||||
.TP
|
||||
\fB\-q\fR, \fB\-\-quiet\fR
|
||||
Quiet mode: only errors are printed
|
||||
.TP
|
||||
\fB\-y\fR, \fB\-\-yes\fR
|
||||
Answer yes to every confirmation prompt
|
||||
.TP
|
||||
\fB\-\-dry\-run\fR
|
||||
Simulate the action without changing anything
|
||||
.TP
|
||||
\fB\-\-json\fR
|
||||
Emit machine\-readable JSON on stdout (for scripts)
|
||||
.TP
|
||||
\fB\-\-no\-color\fR
|
||||
Disable ANSI colors
|
||||
.TP
|
||||
\fB\-\-theme\fR \fI<THEME>\fR
|
||||
Color theme for the output (see \*(Aqam help theme\*(Aq for the list)
|
||||
.TP
|
||||
\fB\-h\fR, \fB\-\-help\fR
|
||||
Print help (see a summary with \*(Aq\-h\*(Aq)
|
||||
.TP
|
||||
\fB\-V\fR, \fB\-\-version\fR
|
||||
Print version
|
||||
.SH SUBCOMMANDS
|
||||
.TP
|
||||
am\-list(1)
|
||||
List installed agents (default); use \-\-all for the whole catalog
|
||||
.TP
|
||||
am\-logs(1)
|
||||
Tail the log file of an agent (\-\-follow for a live view)
|
||||
.TP
|
||||
am\-open(1)
|
||||
Open an agent\*(Aqs installation directory in the file manager
|
||||
.TP
|
||||
am\-watch(1)
|
||||
Supervise an agent and optionally restart it on crash
|
||||
.TP
|
||||
am\-dashboard(1)
|
||||
Live TUI dashboard: overview, activity, stats, sessions, projects
|
||||
.TP
|
||||
am\-favorite(1)
|
||||
Mark an agent as a favorite (star in list and status)
|
||||
.TP
|
||||
am\-unfavorite(1)
|
||||
Remove the favorite star from an agent
|
||||
.TP
|
||||
am\-note(1)
|
||||
Attach a free\-form note to an agent (shown in \*(Aqam info\*(Aq); \*(Aqam note <agent>\*(Aq without text prints the current note
|
||||
.TP
|
||||
am\-tag(1)
|
||||
Add a personal tag to an agent
|
||||
.TP
|
||||
am\-untag(1)
|
||||
Remove a personal tag from an agent
|
||||
.TP
|
||||
am\-tags(1)
|
||||
List personal tags (with counts), optionally for one agent
|
||||
.TP
|
||||
am\-profile(1)
|
||||
Manage environment profiles (dev, prod, ...)
|
||||
.TP
|
||||
am\-man(1)
|
||||
Generate a man page for am (or for one command)
|
||||
.TP
|
||||
am\-alias(1)
|
||||
Manage command aliases (cc \-> claude\-code)
|
||||
.TP
|
||||
am\-secret(1)
|
||||
Manage secrets in the OS keyring (never in plaintext config)
|
||||
.TP
|
||||
am\-start(1)
|
||||
Start an agent (foreground by default, or detached with \-\-background)
|
||||
.TP
|
||||
am\-stop(1)
|
||||
Stop a background agent (SIGTERM, then SIGKILL after the timeout)
|
||||
.TP
|
||||
am\-restart(1)
|
||||
Restart an agent: stop, then start with the same options
|
||||
.TP
|
||||
am\-status(1)
|
||||
Show the state of one agent, or of every installed agent
|
||||
.TP
|
||||
am\-sessions(1)
|
||||
List the sessions of every agent (and of the interactive shell)
|
||||
.TP
|
||||
am\-stats(1)
|
||||
Show usage statistics computed from the event journal
|
||||
.TP
|
||||
am\-top(1)
|
||||
Show the most used agents (top 10)
|
||||
.TP
|
||||
am\-report(1)
|
||||
Write a markdown activity report
|
||||
.TP
|
||||
am\-projects(1)
|
||||
Show which agent works on which project
|
||||
.TP
|
||||
am\-timeline(1)
|
||||
One chronological view of every activity (journal + REPL history)
|
||||
.TP
|
||||
am\-log(1)
|
||||
Read the event journal: everything am did
|
||||
.TP
|
||||
am\-install(1)
|
||||
Install an agent and its dependencies
|
||||
.TP
|
||||
am\-uninstall(1)
|
||||
Uninstall an agent (managed or external) and clean its files
|
||||
.TP
|
||||
am\-update(1)
|
||||
Update an installed agent to the latest available version
|
||||
.TP
|
||||
am\-search(1)
|
||||
Search the catalog by keyword (name, description, category, tags)
|
||||
.TP
|
||||
am\-history(1)
|
||||
Search the command history (am and shell commands)
|
||||
.TP
|
||||
am\-info(1)
|
||||
Show detailed information about one agent
|
||||
.TP
|
||||
am\-init(1)
|
||||
Generate a local agent\-manager.yaml for the current directory
|
||||
.TP
|
||||
am\-help(1)
|
||||
Display help: the overview, a command, the command list, or a search
|
||||
.TP
|
||||
am\-version(1)
|
||||
Display version and build information
|
||||
.TP
|
||||
am\-config(1)
|
||||
Manage the configuration file
|
||||
.TP
|
||||
am\-doctor(1)
|
||||
Check the environment: tools, config validity, paths, permissions
|
||||
.TP
|
||||
am\-run(1)
|
||||
Run the agent command directly with the given arguments (no process management)
|
||||
.TP
|
||||
am\-completion(1)
|
||||
Generate a shell completion script
|
||||
.TP
|
||||
am\-self\-update(1)
|
||||
Update agent\-manager itself from GitHub Releases
|
||||
.TP
|
||||
am\-self\-uninstall(1)
|
||||
Remove agent\-manager and everything it created from this machine
|
||||
.TP
|
||||
am\-export(1)
|
||||
Export the configuration and installation state (backup)
|
||||
.TP
|
||||
am\-import(1)
|
||||
Import a previously exported configuration and state
|
||||
.SH VERSION
|
||||
v0.4.1
|
||||
Reference in New Issue
Block a user