# Exemples d'utilisation Sorties réelles capturées sur Windows 11 (binaire debug). Les couleurs ANSI sont désactivées automatiquement quand la sortie est redirigée ; les exécutables présents sur cette machine sont détectés comme agents « externes » (version détectée via --version, sondée en parallèle et mise en cache). ## Version et aide 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) ## Lister les agents Par défaut, list n'affiche que les agents installés : ceux gérés par agent-manager et ceux détectés sur le PATH (externes). NAME VERSION STATUS SOURCE PATH ------------------------------------------------ Atomic Agent — external external C:\Users\bruno\AppData\Local\atomic-agent\atomi… Claude Code 2.1.112 external external C:\Users\bruno\.local\bin\claude.exe Hermes Agent 2026.8.3 external external C:\Users\bruno\AppData\Local\hermes\hermes-agen… jcode 0.76.0 external external C:\Users\bruno\AppData\Local\jcode\bin\jcode.exe Kimi CLI 0.31.1 external external C:\Users\bruno\.kimi-code\bin\kimi.exe LazyCodex 11.1.0 external external C:\Users\bruno\scoop\apps\nodejs22\current\bin\… nanobot — external external C:\Users\bruno\AppData\Local\Microsoft\WindowsA… NemoClaw — external external C:\Users\bruno\scoop\apps\nodejs22\current\bin\… Pi 0.84.1 external external C:\Users\bruno\scoop\apps\nodejs22\current\bin\… Prime Agent 0.7.2 external external C:\Users\bruno\scoop\apps\nodejs22\current\bin\… Tiny Agents — external external C:\Users\bruno\scoop\apps\python313\current\Scr… Avec --all, le catalogue complet apparaît avec l'état de chacun. NAME VERSION STATUS SOURCE PATH ------------------------------------------------------------- agentty — not-installed - — Aider — not-installed - — Amazon Q Dev CLI — not-installed - — Amp — not-installable - — Ante — not-installed - — Atomic Agent — external external C:\Users\bruno\AppData\Local\atomic-agent\atomi… cc-haha — not-installable - — Claude Code 2.1.112 external external C:\Users\bruno\.local\bin\claude.exe Claurst — not-installed - — Claw Code — not-installed - — ## Rechercher NAME CATEGORY INSTALLABLE DESCRIPTION ------------------------------------------------- Claw Code coding-agent yes Réécriture clean-room Rust/Python de l'architec… jcode coding-agent yes Agent TUI Rust optimisé RAM et latence de démar… Zap coding-agent yes Agent TUI Rust skill-first, injecte seulement l… Smelt coding-agent yes Agent TUI Rust multi-provider, 4 modes (Normal/… Claurst coding-agent yes Claude Code réécrit en Rust idiomatique, avec d… ZeroClaw assistant yes Runtime d'agent AI Rust autonome, architecture … IronClaw assistant yes OpenClaw réécrit en Rust par NEAR AI. Sandbox W… Moltis assistant yes Alternative Rust-native à OpenClaw, zéro code u… Ante proprietary yes Binaire Rust 15 MB (research preview), architec… NAME CATEGORY INSTALLABLE DESCRIPTION ---------------------------------------- no agent matches 'zzzz' (categories: assistant, coding-agent, desktop, local-first, proprietary, saas) ## Fiche détaillée Claude Code slug: claude-code description: Agent terminal d'Anthropic, repo-aware. Édite, refactore, exécute des commandes git et itère sur les erreurs. Le standard de référence du coding agent. category: coding-agent website: https://github.com/anthropics/claude-code tags: anthropic, assistant, source-available, mainstream status: found on PATH (external — not managed) run: claude install methods: 1) type=npm package=@anthropic-ai/claude-code dependencies: - node >= 18.0.0 — https://nodejs.org ## État d'un agent / de tous les agents installés Claude Code (claude-code) status: external version: 2.1.112 method: — path: C:\Users\bruno\.local\bin\claude.exe run: claude NAME VERSION STATUS PID PATH ------------------------------------------- Atomic Agent — external — C:\Users\bruno\AppData\Local\atomic-agent\atomi… Claude Code 2.1.112 external — C:\Users\bruno\.local\bin\claude.exe Hermes Agent 2026.8.3 external — C:\Users\bruno\AppData\Local\hermes\hermes-agen… jcode 0.76.0 external — C:\Users\bruno\AppData\Local\jcode\bin\jcode.exe Kimi CLI 0.31.1 external — C:\Users\bruno\.kimi-code\bin\kimi.exe LazyCodex 11.1.0 external — C:\Users\bruno\scoop\apps\nodejs22\current\bin\… ## Simulation d'installation (--dry-run --verbose) Aucune écriture : les commandes qui seraient exécutées sont affichées (dépendance cargo vérifiée, puis cargo install dans le répertoire local). [dry-run] would run: cargo --version installing Smelt (type=cargo package=smelt)… [dry-run] would run: cargo install --root C:\Users\bruno\AppData\Local\agent-manager\agents\smelt smelt dry run complete — nothing was changed Installer un agent non installable (SaaS) produit une erreur claire : error: agent 'devin' is not installable locally: SaaS — pas d'installation locale; utilisez https://devin.ai (web ou API) [exit code: 1] ## Exécution et groupes [dry-run] would run C:\Users\bruno\scoop\apps\nodejs22\current\bin\pi.cmd [dry-run] would start C:\Users\bruno\.local\bin\claude.exe (detached, log: C:\Users\bruno\AppData\Local\agent-manager\logs\claude-code.log) [dry-run] would start aider (detached, log: C:\Users\bruno\AppData\Local\agent-manager\logs\aider.log) [dry-run] would start codex (detached, log: C:\Users\bruno\AppData\Local\agent-manager\logs\codex.log) ## Arrêt et mise à jour d'un agent non géré agent 'claude-code' is not managed by agent-manager; nothing to stop error: agent 'claude-code' is not installed by agent-manager — use 'am install claude-code' [exit code: 1] ## Sortie JSON (pour les scripts) [ { "name": "agentty", "display_name": "agentty", "category": "coding-agent", "description": "Agent terminal C++26, binaire statique 13.6 MB, cold start sub-milliseconde, zéro dépendance runtime, sandbox par défaut.", "status": "not-installed", "version": null, "source": "-", "method": null, "path": null, "running": false, "pid": null, "installable": true, "note": null }, { "name": "aider", ## Configuration no user config found — using the embedded default catalog user config directory: C:\Users\bruno\AppData\Roaming\agent-manager user config file: C:\Users\bruno\AppData\Roaming\agent-manager\config.yaml local config file: agent-manager.yaml (current directory) configuration is valid (72 agents) ## Doctor CHECK STATUS DETAIL ----------------------------- git ok C:\Users\bruno\scoop\apps\git\current\cmd\git.e… sh ok C:\Users\bruno\scoop\shims\sh.exe (v5.3.15) curl ok C:\Windows\system32\curl.exe (v8.21.0) node ok C:\Users\bruno\scoop\apps\nodejs22\current\node… npm ok C:\Users\bruno\scoop\apps\nodejs22\current\bin\… python3 ok C:\Users\bruno\scoop\shims\python3.exe (v3.13.1… python ok C:\Users\bruno\AppData\Local\Microsoft\WindowsA… cargo ok C:\Users\bruno\scoop\apps\rustup\current\.cargo… go ok C:\Users\bruno\scoop\shims\go.exe (v1.26.5) bun ok C:\Users\bruno\scoop\shims\bun.exe (v1.3.14) uv ok C:\Users\bruno\scoop\shims\uv.exe (v0.12.2) docker ok C:\Program Files\Docker\Docker\resources\bin\do… config warn no user config file found; using the embedded d… config-schema ok 72 agents defined state ok 0 installed agent(s) install-dir warn C:\Users\bruno\AppData\Local\agent-manager\agen… bin-dir warn C:\Users\bruno\AppData\Local\agent-manager\agen… log-dir ok C:\Users\bruno\AppData\Local\agent-manager\logs bin-on-path warn C:\Users\bruno\AppData\Local\agent-manager\agen… 4 problem(s) found — 'am doctor --fix' repairs what it can ## Shell interactif am lancé sans arguments ouvre un shell interactif avec complétion par la touche Tab (commandes, noms d'agents, alias, group:xxx, options) et historique persistant (fichier history.txt dans le répertoire d'état) : $ am agent-manager interactive shell — Tab pour compléter, flèches pour l'historique, 'help', 'exit' am> inst # complète en "install" am> install cla # propose claude-code, claurst, ... am> start group: # propose group:dev, group:local, group:claw, ... am> exit ## Installation réelle de bout en bout (npm) Session complète avec un agent de démonstration défini dans un fichier de config temporaire (paquet npm cowsay) : installation, statut, exécution, erreur propre au démarrage en arrière-plan, mise à jour, désinstallation avec purge. $ am install cowsay --yes installing Cowsay (type=npm package=cowsay)… installed Cowsay (v1.6.0) in .../agents/cowsay start it with: am start cowsay $ am status cowsay Cowsay (cowsay) status: installed version: 1.6.0 method: npm path: .../agents/cowsay/cowsay.cmd run: cowsay installed: 2026-08-15T14:39:26+00:00 $ am run cowsay bonjour ________________ < cowsay bonjour > ---------------- \ ^__^ \ (oo)\_______ (__)\ )\/\ ||----w | || || $ am start cowsay --background error: agent 'cowsay' exited immediately after start (status exit code: 0); log: .../cowsay.log ________ < cowsay > -------- \ ^__^ \ (oo)\_______ (__)\ )\/\ ||----w | || || $ am update cowsay Cowsay is up to date (v1.6.0) $ am uninstall cowsay --purge --yes removed 'cowsay' from .../cowsay.yaml (backup: .../cowsay.yaml.bak) uninstalled Cowsay (files removed, config purged) ## Favoris, notes et tags personnels (v0.4.1) $ am favorite claude-code ⭐ claude-code added to favorites $ am note claude-code use sonnet for this repo note saved for 'claude-code' $ am tag claude-code python frontend tagged 'claude-code' with python, frontend $ am tags ┌───┬────────────┬───────┬─────────────┐ │ # │ TAG │ COUNT │ AGENTS │ ├───┼────────────┼───────┼─────────────┤ │ 0 │ #frontend │ 1 │ claude-code │ │ 1 │ #python │ 1 │ claude-code │ └───┴────────────┴───────┴─────────────┘ L'étoile apparaît dans am list, am status et am info ; les tags sont filtrables avec am search --tag, et tout survit au redémarrage (état v3) : $ am info claude-code | tail tags anthropic · assistant · source-available · mainstream personal ● favorite ★ ● tags #frontend #python ● note use sonnet for this repo $ am search --tag python ┌───┬──────────────────────────┬──────────────┬─────────────┬─────────────┐ │ # │ NAME │ CATEGORY │ INSTALLABLE │ DESCRIPTION │ ├───┼──────────────────────────┼──────────────┼─────────────┼─────────────┤ │ 0 │ ★ Claude Code │ coding-agent │ yes │ Agent termi… │ └───┴──────────────────────────┴──────────────┴─────────────┴─────────────┘ ## Profils d'environnement (v0.4.1) Des profils nommés dans la configuration (env + args + agent par défaut) s'appliquent au lancement : profiles: dev: agent: claude-code env: {DEBUG: "1", LOG_LEVEL: debug} args: [--model, sonnet] prod: env: {LOG_LEVEL: info} $ am profile list PROFILE AGENT ENV ARGS ------- ----------- --------------------- ---------------- dev claude-code DEBUG=1 LOG_LEVEL=… --model sonnet prod — LOG_LEVEL=info — $ am start claude-code --profile dev # lance claude --model sonnet avec DEBUG=1 et LOG_LEVEL=debug $ am start --profile dev # agent par défaut du profil $ am start --profile staging # -> error: unknown profile 'staging' — … # available profiles: dev, prod ## Dashboard TUI (v0.4.1) am dashboard ouvre un tableau de bord temps réel (ratatui/crossterm, aucune dépendance runtime) : vue d'ensemble (statuts, PID, uptime, ★), activité (journal d'événements), stats par agent, sessions et projets. Tab / ← / → changent d'onglet, j/k défilent, q quitte ; rafraîchissement chaque seconde. Sur une sortie non interactive (pipe, script), un instantané texte est affiché à la place : $ am dashboard | head agent-manager dashboard — 2 installed · 1 running · 12 sessions overview ★ claude-code running 2.1.233 pid 4242 (up 3h12m) aider installed 0.76.0 — codex external — — $ am dashboard --json # l'instantané complet en JSON pour les scripts ## Pages de manuel et complétions dynamiques (v0.4.1) $ am man dashboard .TH am-dashboard 1 "dashboard " .SH NAME dashboard - Live TUI dashboard: overview, activity, stats, sessions, projects ... $ am man --output man/ # am.1 + une page par commande (44 pages) man pages written to man/ (am.1 + 44 pages) $ am completion bash --installed # Tab complète dynamiquement les # agents installés, alias et groupes # (interroge 'am _agents --installed')