bruno
d9ffc34156
Axe 8 (sécurité) : - am audit : checksums SHA-256 des configs (embarquée, utilisateur, locale) stockés dans state.json, croisement avec events.jsonl pour dater les changements, détection des modifications manuelles hors de am (statut MANUAL), rapport lisible + --json stable (contrat) - backup automatique avant chaque am update (agent ou --all) : état + config utilisateur + répertoires d'installation + shims dans <state>/backups/<ts>/ avec manifest.json - am update --rollback [point] : restaure le dernier backup (ou un id précis, préfixe accepté), arrête les agents concernés d'abord, événement EventKind::Rollback journalisé - am update --rollback list : liste les points de restauration - rétention settings.backups_keep (défaut 5) appliquée après chaque backup - événements EventKind::Backup / EventKind::Rollback pour l'audit REPL : commande audit + update --rollback (parse, complétion), help specs, tip cheat sheet, man pages régénérées (50 pages). Version 0.4.6, ROADMAP cases cochées, 272 tests verts.
196 lines
5.1 KiB
Groff
196 lines
5.1 KiB
Groff
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.TH am 1 "am 0.4.6"
|
|
.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\-theme(1)
|
|
Set or show the active color theme (persisted for the next run)
|
|
.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\-audit(1)
|
|
Audit the configuration: who changed what, when (issue #63)
|
|
.TP
|
|
am\-models(1)
|
|
List local models (ollama, llama.cpp, LM Studio) and prune unused ones
|
|
.TP
|
|
am\-catalog(1)
|
|
Manage remote catalogs: update the official one, add external ones
|
|
.TP
|
|
am\-suggest(1)
|
|
Suggest agents matching a query, boosted by real usage (issue #61)
|
|
.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\-tip(1)
|
|
Cheat sheet: the most useful commands, their key options, your most\-used commands and a rotating tip of the day
|
|
.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 the latest release
|
|
.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.6
|