384 lines
17 KiB
Markdown
384 lines
17 KiB
Markdown
# 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')
|