.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