Chaque sous-commande kirocrew, regroupée selon ce qu'elle fait. Exécutez kirocrew <cmd> --help pour obtenir la liste faisant autorité des indicateurs de votre version installée — cette page reflète la forme actuelle.
S'applique à chaque sous-commande.
| Indicateur | Objectif |
|---|---|
--port <n> | Remplacer le port de la passerelle (par défaut : KIROCREW_PORT ou 5476) |
--home <path> | Remplacer le répertoire des données (par défaut : KIROCREW_HOME ou ~/.kiro/crew) |
--verbose | Augmenter le niveau de détail de la journalisation |
--help | Afficher l'aide de la sous-commande |
--version | Afficher la version de kirocrew et quitter |
Variables d'environnement respectées par la CLI :
| Variable | Valeur par défaut | Objectif |
|---|---|---|
KIROCREW_HOME | ~/.kiro/crew | Répertoire des données |
KIROCREW_PORT | 5476 | Port de la passerelle |
KIROCREW_EMBED_MODEL_URL | (CDN) | Remplacer l'URL de téléchargement du modèle d'incorporation |
KIROCREW_ALLOW_UNSANDBOXED | (non défini) | Dans Docker, autoriser explicitement l'exécution de l'agent sans le bac à sable interne |
Assistant interactif. Demande le répertoire des données, le backend de l'agent et (facultativement) les jetons Slack. Ignorez les jetons Slack pour fonctionner en mode tableau de bord seulement.
kirocrew setup kirocrew setup --agent-only # only redo the agent config kirocrew setup --agent-only --clean # nuke and rebuild MCP config
Vérification de l'état de santé. Signale l'état de chaque sous-système :
kiro-cliDémarrer le serveur. Bloque au premier plan jusqu'à Ctrl+C.
kirocrew gateway # → http://localhost:5476 kirocrew gateway --port auto # OS-assigned port; prints KIROCREW_READY:{...} kirocrew gateway --port 6777 # custom port kirocrew gateway --no-crons # skip the cron scheduler (multi-instance setups) kirocrew gateway --test-mode # ephemeral port + json-ready + reads-only approval kirocrew gateway --approval reads # auto-approve read-only tools kirocrew gateway --approval yolo # auto-approve ALL tools (requires non-default KIROCREW_HOME)
Arrêter ou redémarrer la passerelle en cours d'exécution. Atomique sur systemd; décharge + charge sur launchd.
Suivre les journaux de la passerelle en direct.
kirocrew logs # last 200 lines kirocrew logs -f # follow kirocrew logs -n 500 # last 500 lines
S'enregistrer comme service système afin que la passerelle survive aux déconnexions SSH et redémarre automatiquement en cas de plantage.
kirocrew service install # systemd (Linux) or launchd (macOS) kirocrew service status kirocrew service uninstall
Mise à jour automatique. git pull + reconstruction + pip install -e . + redémarrage par execv.
Créer un lien de connexion au tableau de bord de courte durée. Affiche l'URL.
kirocrew token --ttl 2h # 2-hour token kirocrew token --port 6777 # for a specific gateway port
REPL interactif ou requête unique.
kirocrew chat # REPL kirocrew chat "one-shot query" # one-shot; prints response kirocrew chat --agent reviewer # use a named agent kirocrew chat --json # machine-readable output echo "prompt" | kirocrew chat # headless stdin
Commandes à barre oblique à l'intérieur du REPL : /compact, /model, /incognito, /clear, /help, /exit.
Exécuter une tâche à partir d'un fichier spec.
kirocrew run TASK.md # auto-resume from checkpoint kirocrew run TASK.md --fresh # ignore checkpoint, start over kirocrew run TASK.md --no-test # skip test verification kirocrew run TASK.md --timeout 3600 # global timeout kirocrew run TASK.md --agent <name> # use a named agent
Afficher l'état des exécutions de tâches actives.
Annuler une exécution de tâche.
kirocrew run cancel <task_id> # specific task kirocrew run cancel # all running tasks
Créer une tâche planifiée.
kirocrew cron add "name" "prompt" --cron "0 9 * * 1-5" kirocrew cron add "name" "prompt" --every 300
Indicateurs :
| Indicateur | Objectif |
|---|---|
--cron "<expr>" | Expression cron standard (mutuellement exclusive avec --every) |
--every <secs> | Intervalle en secondes |
--timezone "<tz>" | Fuseau horaire par tâche (nom IANA; UTC par défaut) |
--skip-dates "YYYY-MM-DD,..." | Exclure des dates précises |
--timeout-secs <n> | Délai d'expiration par tâche (par défaut 1800) |
--agent <name> | Agent sous lequel exécuter |
--persistent-session | Réutiliser la même session entre les exécutions |
--silent | Aucune notification, sauf si l'agent en envoie une |
--strict-schedule | Désactiver la variation aléatoire d'exécution |
kirocrew cron list kirocrew cron remove <job_id> kirocrew cron remove-all kirocrew cron pause <job_id> kirocrew cron resume <job_id> kirocrew cron trigger <job_id> # run once manually kirocrew cron update <job_id> --cron "0 10 * * *"
Générer un sous-agent en arrière-plan.
kirocrew spawn run "check my open CRs" # blocking kirocrew spawn run --async "check CRs" # fire-and-forget kirocrew spawn run --agent reviewer "review X" kirocrew spawn run --cwd /path/to/project "..." # subagent runs in a specific dir
Lister les sous-agents actifs avec leurs ID, leur état et le temps écoulé.
Ajouter une leçon injectée dans chaque future session.
kirocrew learn add "always use TypeScript over JavaScript" kirocrew learn add "prefer pytest over unittest" --category tool kirocrew learn add "use exact-match on strings" --scope workspace
Catégories : general, tool, style, workflow. Portées : global (par défaut), workspace.
kirocrew learn list kirocrew learn list --category tool kirocrew learn remove "prefer pytest"
Créer une sauvegarde tarball de tout l'état.
kirocrew snapshot # → ~/.kiro/crew/snapshots/ kirocrew snapshot ~/my-snapshots # custom dir kirocrew snapshot ~/my-snapshots --keep 3 # prune to 3 most recent kirocrew snapshot --list # list existing snapshots
Restaurer à partir d'un tarball.
kirocrew restore snapshot.tar.gz # auto-detect replace vs merge kirocrew restore snapshot.tar.gz --mode replace kirocrew restore snapshot.tar.gz --components memory,crons kirocrew restore snapshot.tar.gz --dry-run kirocrew restore --list-components # show valid components
kirocrew config get # print full config kirocrew config get agent.sandbox # print one key kirocrew config set dashboard.bot_name "X" # set a key kirocrew config unset dashboard.bot_name # remove a key kirocrew config edit # open in $EDITOR
La définition d'une valeur déclenche automatiquement un redémarrage du bassin de sessions afin que le changement prenne effet immédiatement.
Activer ou désactiver le mode développement à rechargement en direct pour une application installée.
kirocrew app dev my-app # turn on kirocrew app dev my-app --off # turn off
En mode développement, la passerelle surveille le répertoire ui/ de l'application et diffuse un événement WebSocket app_reload à chaque changement de fichier. Le tableau de bord recharge l'application immédiatement.
Générer un manifeste d'application Slack.
kirocrew manifest # print YAML manifest to stdout kirocrew manifest --url # print a Slack "Create New App from manifest" URL kirocrew manifest -o slack.yaml # write manifest to a file
Résumé des statistiques d'exécution — nombre de messages, appels d'outils, métriques de session, générations de sous-agents.
kirocrew status kirocrew status --json
Exécuter le harnais d'évaluation multi-session.
kirocrew eval # smoke test kirocrew eval --all # every scenario kirocrew eval --scenario <name> # single scenario
Nécessite l'exécution de kirocrew gateway --test-mode dans un autre shell.
Lister les applications adressables par les outils MCP d'utilisation de l'ordinateur (macOS seulement).
Harnais de débogage humain pour les outils d'utilisation de l'ordinateur. Exécute les dix outils MCP computer_* à travers le même point de contrôle contrôlé. Non destiné aux appelants LLM.
kirocrew computer call computer_list_apps kirocrew computer call --calls '[{"tool":"computer_click","args":{...}}]'
À l'intérieur d'un conteneur Docker en cours d'exécution :
docker exec kirocrew kirocrew token --ttl 2h # mint a login link docker exec -it kirocrew kiro-cli login # log in the agent runtime docker exec -u 0 kirocrew chown kirocrew:kirocrew <path> # fix ownership after docker cp
Invalider le jeton actuel du tableau de bord.
kirocrew setup && kirocrew doctor && kirocrew gateway
kirocrew setup --agent-only --clean
# on source kirocrew snapshot ~/migrate # copy tarball to new machine, then: kirocrew restore ~/migrate/snapshot-*.tar.gz kirocrew doctor
kirocrew service install kirocrew token --ttl 20h # open the printed URL on your local machine (via SSH tunnel or reverse proxy)
| Code | Signification |
|---|---|
0 | Succès |
1 | Erreur générique |
2 | Arguments invalides |
3 | Passerelle non en cours d'exécution (pour les commandes CLI qui en ont besoin) |
10 | Échec de la vérification de l'état de santé (kirocrew doctor) |
kirocrew --help — liste des commandes de premier niveaukirocrew <cmd> --help — aide spécifique à la sous-commandekirocrew doctor --verbose — sortie de diagnostic complète
Référence de la CLI