17 KiB
17 KiB
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<Tab> # complète en "install"
am> install cla<Tab> # propose claude-code, claurst, ...
am> start group:<Tab> # 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')