agent-manager v0.2.0 : gestionnaire d'agents IA locaux

- CLI Rust (am) : list/install/uninstall/update/start/stop/restart/run/status/search/info/config/doctor/completion/export/import/self-update + shell interactif (Tab, historique) - 9 methodes d'installation (npm, pip, uv, cargo, go, bun, curl, binary, git) - catalogue de 72 agents, dependances, processus, securite (dry-run, checksums) - sondes de version paralleles + cache (am list ~25 ms a chaud) - installateurs one-liner : install.sh, install.ps1
2026-08-15 11:26:34 -04:00
commit 8ee3ddf3db
79 changed files with 15724 additions and 0 deletions
@@ -0,0 +1,217 @@
+//! Command line interface definition (clap v4, derive API).
+
+use clap::{ArgAction, Args, Parser, Subcommand};
+use clap_complete::Shell;
+use std::path::PathBuf;
+
+/// Manage local AI coding agents: install, start, stop, update.
+#[derive(Parser, Debug, Clone)]
+#[command(
+    name = "am",
+    bin_name = "am",
+    version,
+    about = "agent-manager (am) — manage local AI coding agents",
+    long_about = "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."
+)]
+pub struct Cli {
+    /// Use an alternate configuration file
+    #[arg(short = 'c', long, global = true, value_name = "FILE")]
+    pub config: Option<PathBuf>,
+
+    /// Verbose output: show every command executed and its details
+    #[arg(short = 'v', long, global = true, action = ArgAction::SetTrue)]
+    pub verbose: bool,
+
+    /// Quiet mode: only errors are printed
+    #[arg(short = 'q', long, global = true, conflicts_with = "verbose", action = ArgAction::SetTrue)]
+    pub quiet: bool,
+
+    /// Answer yes to every confirmation prompt
+    #[arg(short = 'y', long, global = true, action = ArgAction::SetTrue)]
+    pub yes: bool,
+
+    /// Simulate the action without changing anything
+    #[arg(long, global = true, action = ArgAction::SetTrue)]
+    pub dry_run: bool,
+
+    /// Emit machine-readable JSON on stdout (for scripts)
+    #[arg(long, global = true, action = ArgAction::SetTrue)]
+    pub json: bool,
+
+    /// Disable ANSI colors
+    #[arg(long, global = true, action = ArgAction::SetTrue)]
+    pub no_color: bool,
+
+    #[command(subcommand)]
+    pub command: Option<Command>,
+}
+
+#[derive(Subcommand, Debug, Clone)]
+pub enum Command {
+    /// List installed agents (default); use --all for the whole catalog
+    List {
+        /// Show every agent known to the catalog, not only the installed ones
+        #[arg(long)]
+        all: bool,
+        /// Only show agents of this category
+        #[arg(long, value_name = "CATEGORY")]
+        category: Option<String>,
+    },
+    /// Start an agent (foreground by default, or detached with --background)
+    Start(StartArgs),
+    /// Stop a background agent (SIGTERM, then SIGKILL after the timeout)
+    Stop {
+        /// Agent name, alias, or group:<name>
+        agent: String,
+        /// Kill immediately instead of terminating gracefully
+        #[arg(long)]
+        force: bool,
+        /// Grace period in seconds before killing (default: from config, 5s)
+        #[arg(long, value_name = "SECS")]
+        timeout: Option<u64>,
+    },
+    /// Restart an agent: stop, then start with the same options
+    Restart {
+        #[command(flatten)]
+        start: StartArgs,
+        /// Kill immediately instead of terminating gracefully
+        #[arg(long)]
+        force: bool,
+        /// Grace period in seconds before killing (default: from config, 5s)
+        #[arg(long, value_name = "SECS")]
+        timeout: Option<u64>,
+    },
+    /// Show the state of one agent, or of every installed agent
+    Status {
+        /// Agent name or alias (omit to show all installed agents)
+        agent: Option<String>,
+    },
+    /// Install an agent and its dependencies
+    Install {
+        /// Agent name or alias
+        agent: String,
+        /// Select the install method (index, or type: npm, pip, uv, cargo, go, bun, curl, binary, git)
+        #[arg(long, value_name = "METHOD")]
+        method: Option<String>,
+        /// Reinstall even if already installed
+        #[arg(long)]
+        force: bool,
+    },
+    /// Uninstall an agent and clean its files
+    Uninstall {
+        /// Agent name or alias
+        agent: String,
+        /// Also remove logs and the agent entry from the user config file
+        #[arg(long)]
+        purge: bool,
+    },
+    /// Update an installed agent to the latest available version
+    Update {
+        /// Agent name or alias (required unless --all)
+        agent: Option<String>,
+        /// Update every installed managed agent
+        #[arg(long)]
+        all: bool,
+    },
+    /// Search the catalog by keyword (name, description, category, tags)
+    Search {
+        /// Keyword to search for (case-insensitive substring)
+        keyword: String,
+        /// Restrict to this category
+        #[arg(long, value_name = "CATEGORY")]
+        category: Option<String>,
+    },
+    /// Show detailed information about one agent
+    Info {
+        /// Agent name or alias
+        agent: String,
+    },
+    /// Manage the configuration file
+    #[command(subcommand)]
+    Config(ConfigCmd),
+    /// Check the environment: tools, config validity, paths, permissions
+    Doctor {
+        /// Attempt to repair problems (create directories, fix the state file)
+        #[arg(long)]
+        fix: bool,
+    },
+    /// Run the agent command directly with the given arguments (no process management)
+    Run {
+        /// Agent name or alias
+        agent: String,
+        /// Arguments passed through to the agent command
+        #[arg(trailing_var_arg = true, allow_hyphen_values = true, value_name = "ARGS...")]
+        args: Vec<std::ffi::OsString>,
+    },
+    /// Generate a shell completion script
+    Completion {
+        /// Shell to generate completions for
+        #[arg(value_enum, value_name = "SHELL")]
+        shell: Shell,
+    },
+    /// Update agent-manager itself from GitHub Releases
+    SelfUpdate {
+        /// Only check whether a newer version exists
+        #[arg(long)]
+        check: bool,
+        /// Download the new binary to this path instead of replacing the current one
+        #[arg(long, value_name = "FILE")]
+        to: Option<PathBuf>,
+    },
+    /// Export the configuration and installation state (backup)
+    Export {
+        /// Output file (default: am-export.json)
+        #[arg(long, value_name = "FILE", default_value = "am-export.json")]
+        output: PathBuf,
+    },
+    /// Import a previously exported configuration and state
+    Import {
+        /// File exported by the export command
+        file: PathBuf,
+    },
+}
+
+/// Arguments shared by start and restart.
+#[derive(Args, Debug, Clone, Default)]
+pub struct StartArgs {
+    /// Agent name, alias, or group:<name>
+    pub agent: String,
+    /// Run detached in the background; output goes to the agent log file
+    #[arg(short = 'b', long, conflicts_with = "foreground", action = ArgAction::SetTrue)]
+    pub background: bool,
+    /// Run in the foreground, attached to this terminal (the default)
+    #[arg(short = 'f', long, action = ArgAction::SetTrue)]
+    pub foreground: bool,
+    /// Extra arguments passed to the agent (repeatable; quoted strings are split on spaces)
+    #[arg(long, value_name = "ARGS", num_args = 0.., action = ArgAction::Append)]
+    pub args: Vec<String>,
+    /// Set an environment variable for the agent (repeatable): --env KEY=VALUE
+    #[arg(long, value_name = "KEY=VALUE", action = ArgAction::Append)]
+    pub env: Vec<String>,
+    /// Send a desktop notification once the agent has started
+    #[arg(long, action = ArgAction::SetTrue)]
+    pub notify: bool,
+}
+
+/// Configuration management subcommands.
+#[derive(Subcommand, Debug, Clone)]
+pub enum ConfigCmd {
+    /// Print the effective (merged) configuration as YAML
+    Show,
+    /// Print the location of the configuration file(s)
+    Path,
+    /// Open the user configuration file in your editor
+    Edit,
+    /// Validate the configuration file(s)
+    Validate,
+    /// Add another agent definition file to the user configuration
+    Add {
+        /// YAML (or JSON) file defining agents to include
+        file: PathBuf,
+    },
+}