agent-manager (am) — a CLI to manage local AI coding agents.

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.

Usage: am [OPTIONS] [COMMAND]

Commands:
  list         List installed agents (default); use --all for the whole catalog
  start        Start an agent (foreground by default, or detached with --background)
  stop         Stop a background agent (SIGTERM, then SIGKILL after the timeout)
  restart      Restart an agent: stop, then start with the same options
  status       Show the state of one agent, or of every installed agent
  install      Install an agent and its dependencies
  uninstall    Uninstall an agent and clean its files
  update       Update an installed agent to the latest available version
  search       Search the catalog by keyword (name, description, category, tags)
  info         Show detailed information about one agent
  config       Manage the configuration file
  doctor       Check the environment: tools, config validity, paths, permissions
  run          Run the agent command directly with the given arguments (no process management)
  completion   Generate a shell completion script
  self-update  Update agent-manager itself from GitHub Releases
  export       Export the configuration and installation state (backup)
  import       Import a previously exported configuration and state
  help         Print this message or the help of the given subcommand(s)

Options:
  -c, --config <FILE>
          Use an alternate configuration file

  -v, --verbose
          Verbose output: show every command executed and its details

  -q, --quiet
          Quiet mode: only errors are printed

  -y, --yes
          Answer yes to every confirmation prompt

      --dry-run
          Simulate the action without changing anything

      --json
          Emit machine-readable JSON on stdout (for scripts)

      --no-color
          Disable ANSI colors

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version