Projets/agent-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 4 Releases 34 Wiki Activity
Files
deeb489b4e830d87aa719ad48a87ff4c18486d53
agent-manager/EXAMPLES.md
T
bruno 8ee3ddf3db 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

288 lines
12 KiB
Markdown
Raw Blame History

# 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)
Reference in New Issue View Git Blame Copy Permalink