La majorité de la configuration se gère depuis le panneau Paramètres du tableau de bord. La passerelle surveille config.json et config.local.json, de sorte que la plupart des changements prennent effet dès qu'ils sont enregistrés. Des champs comme la commande slash Slack et mcp.honour_auto_approve portent un badge Les changements nécessitent un redémarrage. Les changements d'identifiants nécessitent également un redémarrage avant que l'intégration concernée se reconnecte.
| Section | Ce que vous configurez |
|---|---|
| Overview | État rapide, heures de programmation et informations système |
| Import / Export | Données provenant d'un autre agent d'IA, et sauvegarde ou restauration de la configuration de Kiro Crew, avec l'historique de clavardage au besoin |
| Agent Harness | L'agent avec lequel démarrent les nouvelles sessions, Subagent Settings et Pre-started Sessions |
| Chat | Mode de mémoire, modèles, comportement du compositeur, motifs de liens et délais d'expiration |
| Display | Thème, typographie, zoom, terminal et disposition |
| Voice | Fournisseur de dictée, microphone, voix TTS et vitesse |
| Notifications | Préférences de bannière et d'alertes de bureau |
| Secrets | Identifiants en écriture seule pour les intégrations gérées, notamment WakaTime |
| Shortcuts | Personnalisation des raccourcis clavier |
| Skills | Découverte des Skills et limites d'injection de déclencheurs |
| Messaging Channels | Slack, Discord, Telegram, Teams, Webex, WeCom, WeChat et autres canaux |
| Browser | Paramètres d'automatisation du navigateur |
| Computer Use | Automatisation du bureau natif |
| Remote Crew | Connexions SSH, AWS SSM et Fargate |
| Security | Bac à sable, commandes refusées et gouvernance |
| Developer | Backends d'agents, télémétrie et Aperçus de fonctionnalités |
| About | Version, canal de publication et mises à jour |
La configuration des agents et des crewmates se trouve hors des Paramètres, sous Personnaliser dans la barre latérale (libellé Capacités de l'agent avant la version 0.9). Subagent Settings et la carte Pre-started Sessions (anciennement Warm Pool) ont été déplacés vers Paramètres → Agent Harness.
Paramètres → Import / Export sauvegarde la configuration de Kiro Crew dans une archive et la restaure. Cochez Inclure l'historique de clavardage pour ajouter chaque clavardage de votre liste Sessions à l'exportation. Les clavardages Incognito et Temporaire ne sont jamais inclus. Les clavardages conservent tout ce qui y a été collé, comme des mots de passe ou des clés; gardez donc l'archive privée.
Les clavardages plus anciens qui n'entrent pas dans l'archive sont laissés de côté, et l'exportation les nomme. À l'importation, les clavardages Incognito, Temporaire ou illisibles sont retenus et nommés.
- Paramètres → Chat → Transcription → Verbosité des réponses règle la concision de la prose de l'agent. Une nouvelle installation démarre à Réponse seulement; une configuration existante conserve le niveau enregistré. L'ancien niveau Ultra est retiré, et une configuration qui l'avait enregistré se comporte comme Réponse seulement. À tous les niveaux, le code, les commandes et les chaînes d'erreur restent intacts.
- Paramètres → Chat → Avancé → Limite de temps de compaction (secondes) (
session.compact_wait_secs) est la durée maximale d'une compaction.0signifie la valeur par défaut de 300 secondes; sinon de 60 à 3 600 secondes, et une valeur hors de cette plage est ramenée dans la plage. Ce qui se passe au-delà de la limite dépend de qui a lancé la compaction : la compaction automatique et celle de l'exécuteur de tâches redémarrent la session, la compaction en approche de limite d'un canal de clavardage abandonne et conserve la session, et un/compactmanuel signale qu'il a expiré. - Paramètres → Chat → Sessions → Atténuer les volets inactifs estompe les volets en vue partagée sans focus clavier. Désactivez-le pour garder chaque volet à pleine luminosité; la bordure d'accent marque toujours le volet actif.
L'intégration WakaTime est désactivée par défaut. Lorsqu'elle est activée, Kiro Crew envoie des signaux d'activité de programmation à WakaTime et consulte les statistiques du compte.
- Définissez
wakatime.enabledàtruedans$KIROCREW_HOME/config.json(par défaut :~/.kiro/crew/config.json). - Ouvrez Paramètres → Secrets et enregistrez la clé API WakaTime sous Utilisés automatiquement par Kiro Crew. L'identifiant
WAKATIME_API_KEYest stocké uniquement dans le coffre-fort; Kiro Crew ne le lit pas depuis.envniconfig.json. - Ouvrez Paramètres → Aperçu.
Par défaut, la carte affiche 7 derniers jours. Choisissez Aujourd'hui, 7 derniers jours, 30 derniers jours ou 6 derniers mois pour voir le temps total de programmation, la moyenne quotidienne, les projets actifs et la répartition par langage et par projet. Exporter les heures (CSV) et Exporter les heures (JSON) téléchargent les heures regroupées par projet pour la plage de dates sélectionnée.
Obtenez une clé API dans les paramètres du compte WakaTime.
kirocrew config get kirocrew config get agent.sandbox kirocrew config set dashboard.bot_name "X" kirocrew config set --local dashboard.bot_name "X" kirocrew config edit
--local écrit dans config.local.json, dont les valeurs remplacent config.json et survivent à une mise à jour. Les deux fichiers utilisent du JSON standard; les clés omises utilisent les valeurs par défaut livrées actuelles. Le chargeur en direct applique les changements ordinaires sans redémarrer les sessions. Lorsqu'un champ est marqué comme nécessitant un redémarrage, redémarrez après l'avoir enregistré.
{ "agent": { "approval_mode": "auto", "sandbox": "auto" }, "session": { "timeout_secs": 3600, "autocompact_pct": 70 }, "dashboard": { "default_memory_mode": "persistent" }, "skills": { "max_triggered": 0 } }
| Clé | Valeur par défaut | Signification |
|---|---|---|
agent.chat_turn_timeout_secs | 14400 | Durée maximale, en temps réel, d'un tour de clavardage |
agent.subagent_timeout_secs | 10800 | Durée maximale, en temps réel, d'un sous-agent |
agent.subagent_max_turns | 1000 | Budget d'appels d'outils par sous-agent, plafonné à 1000 |
agent.session_control | true | Permet aux agents admissibles de créer, lire, contacter et arrêter des sessions pairs |
agent.refusal_fallback_model | "" | Modèle utilisé pour une nouvelle tentative après un refus du filtre de contenu; vide désactive la nouvelle tentative |
session.timeout_secs | 3600 | Délai d'expiration d'une session inactive en secondes; 0 désactive le balayage d'inactivité |
session.autocompact_pct | 70 | Pourcentage d'utilisation du contexte qui démarre la compaction automatique |
orchestrator.max_plan_duration_seconds | 7200 | Limite pour l'ensemble d'un plan d'exécution automatique sans supervision; 0 la supprime |
agent.sandbox | "auto" | Choisit auto, strict ou off pour les nouveaux sous-processus d'agent; consultez Sécurité |
agent.sandbox_allow_unsandboxed_exec | false | Autorise l'exécution sans bac à sable uniquement lorsqu'elle est explicitement activée |
agent.deepseek_env | {} | Associe les noms de variables d'environnement du DeepSeek Harness à des références secret:// du coffre-fort |
dashboard.default_memory_mode | "persistent" | Mode de mémoire des nouveaux clavardages du tableau de bord : persistent, incognito ou temporary |
dashboard.model_picker_hidden_models | [] | Modèles masqués par Modèles sélectionnables; Auto et le modèle actif restent visibles |
dashboard.link_patterns | [] | Paires d'expression régulière JavaScript et de modèle d'URL absolue utilisées par les Motifs de liens texte |
dashboard.title_refresh_every_turns | 0 | Revérifie un titre généré automatiquement tous les N tours; 0 conserve la cadence intégrée |
dashboard.terminal.completion.enabled | true | Active la saisie semi-automatique des commandes et des chemins dans le terminal |
memory.persistence_enabled | true | Active les écritures de mémoire automatiques et la consolidation |
memory.inject_memory | true | Ajoute la mémoire enregistrée au contexte des nouvelles sessions |
memory.inject_lessons | true | Ajoute les corrections apprises au contexte des nouvelles sessions |
memory.inject_activity | true | Ajoute les projets récents, l'historique, les faits de tâches et les épisodes passés |
mcp.honour_auto_approve | true | Respecte les listes autoApprove écrites par le propriétaire dans les fichiers MCP et d'agent; les listes des applications restent ignorées. Nécessite un redémarrage de la passerelle |
monitoring.max_runtime_secs | 604800 | Plafond de l'opérateur pour un moniteur nouveau ou mis à jour, jusqu'à trente jours |
skills.max_triggered | 0 | Nombre maximal de Skills correspondants injectés par message; 0 désactive l'injection de déclencheurs, pas la découverte |
wakatime.enabled | false | Active le rapport des heures de programmation une fois la clé API stockée dans le coffre-fort de secrets |
telemetry.enabled | false | Active les métriques locales de latence et de taux de défaillance; il ne les exporte pas |
auto_update | true | Vérifie les mises à jour des installations source au démarrage et toutes les douze heures |
instances.enabled | false | Active la gestion des crews distants et multi-instances |
instances.warm_set_cap | 0 | Limite fixe de tunnels actifs; 0 la dimensionne automatiquement, plafonnée à 8 |
capabilities.publish | Désactivée | Capacité de gouvernance pour la publication publique d'artefacts |
publish.allowed_destinations | [] | Fournisseurs autorisés sous le plafond de gouvernance de publication |
Activez Paramètres → Développeur → Aperçus de fonctionnalités → Décisions (Jev) uniquement après avoir examiné la destination et les catégories de données indiquées sur la carte. Le consentement est stocké en dehors de config.json, de sorte qu'un agent ne peut pas activer le transfert en modifiant les paramètres.
Activer le commutateur principal n'arme pas chaque comportement. Choisissez Auto (Jev) dans le sélecteur de modèle d'un clavardage pour le routage de modèle par tour, et Auto (Jev) sur le bouton d'envoi occupé pour les décisions Diriger-ou-Mettre-en-file. La sélection automatique de Skills nécessite également skills.max_triggered supérieur à zéro; ce paramètre active globalement l'injection de déclencheurs par message, pas seulement Jev. Le filtrage de la mémoire rappelée et les mesures facultatives de risque d'outil et de compaction ont chacun leur propre commutateur de consentement.
Paramètres pertinents :
| Clé | Valeur par défaut | Signification |
|---|---|---|
decisions.bucket | 100 | Pourcentage des sessions autrement admissibles incluses dans l'échantillon stable |
decisions.history_budget_chars | 0 | Nombre maximal de caractères de conversation antérieure envoyés avec une décision; 0 n'en envoie aucun |
decisions.model_route.simple | "" | Modèle pour les messages que Jev classe comme simples; vide conserve le modèle actuel |
decisions.model_route.medium | "" | Modèle pour les messages moyens |
decisions.model_route.complex | "" | Modèle pour les messages complexes |
Une sélection concrète de modèle l'emporte toujours sur Auto (Jev). Les tâches planifiées, les sous-agents, les requêtes d'application et les tours de crews distants conservent leurs propres paramètres de modèle.
Choisissez un thème, une typographie et une langue d'interface dans Paramètres → Affichage. L'interface est offerte en anglais, allemand, espagnol, français, italien, portugais, russe, hindi, bengali, chinois, coréen et japonais. La langue de réponse de l'agent suit votre conversation plutôt que ce paramètre d'affichage.
Dans l'application de bureau, Paramètres → Affichage → Niveau de zoom accepte un pourcentage exact saisi, limité de 50 à 300 pour cent. Un onglet de navigateur ne peut pas régler le zoom du navigateur lui-même; le paramètre affiche donc plutôt l'indication du raccourci clavier.
Dans Kiro Crew 0.12.0 ou une version ultérieure, Paramètres → Affichage → Thème ajoute Color-blind safe et Amethyst OLED aux thèmes intégrés. Chaque ligne des Paramètres affiche une courte phrase sur son effet; l'explication plus longue se trouve derrière l'infobulle de la ligne.
Paramètres → Chat → Avancé → Seuil de compaction automatique (session.autocompact_pct, par défaut 70) est le pourcentage d'utilisation du contexte à partir duquel la compaction automatique démarre. Dans Kiro Crew 0.12.0 ou une version ultérieure, son option Personnalisé accepte n'importe quel pourcentage exact de 5 à 90. Il ne s'applique pas aux sessions Kiro Agent, qui se compactent d'elles-mêmes.
Sous Paramètres → Notifications, dans Kiro Crew 0.12.0 ou une version ultérieure :
- Notifications poussées → M'avertir même quand Kiro Crew est fermé envoie des alertes à cet appareil après la fermeture de la fenêtre ou de l'onglet Kiro Crew, par le tableau de bord installé comme application Web. La passerelle doit continuer de s'exécuter : une passerelle démarrée par l'application de bureau s'arrête avec elle lorsque Continuer de s'exécuter en arrière-plan après la fermeture de la fenêtre est désactivé. Sur iOS, ajoutez d'abord le tableau de bord à l'écran d'accueil. Lorsque vous activez le commutateur, le navigateur demande d'autoriser les notifications; si vous refusez, le commutateur reste désactivé et l'indique. Les notifications système ordinaires s'arrêtent à la fermeture de Kiro Crew; les alertes poussées continuent par l'application Web installée tant que la passerelle s'exécute, et s'arrêtent quand la passerelle s'arrête, même si l'autorisation du navigateur reste accordée.
- Sons personnalisés accepte un court fichier MP3, WAV ou OGG pour n'importe quelle catégorie de notification : jusqu'à 5 secondes et 256 Ko.
- Une approbation qui expire sans réponse laisse une note dans la cloche nommant l'outil. Un clavardage qui s'arrête sur une erreur exigeant votre intervention laisse une entrée Erreurs de clavardage dans la cloche, avec un lien vers celui-ci.
Chaque commutateur sous Paramètres → Développeur → Aperçus de fonctionnalités est désactivé par défaut et enregistré sur la passerelle; il s'applique donc dans chaque navigateur et dans l'application de bureau. Deux aperçus ajoutés dans Kiro Crew 0.12.0 n'ont pas de page propre :
- Shared Crew est un commutateur réservé au propriétaire qui prend effet après un redémarrage de la passerelle. Il active un onglet Personnes, où une carte en deux étapes (Partager cette machine sur Tailscale, puis Leur envoyer le lien Crew) partage cette machine par Tailscale et copie un message d'invitation. Aucun champ de configuration ni aucun agent ne peut activer cet aperçu; seul le propriétaire le peut. Tailscale décide qui entre, y compris toute personne que ses règles d'accès laissent atteindre cette machine, pas seulement les personnes que vous invitez. Chaque personne admise peut voir toutes les sessions et la mémoire du Crew, ouvrir et exécuter des clavardages, et dispose des mêmes droits d'application; il n'y a ni rôles ni contrôles d'accès par session dans cette version. Les cartes d'approbation et de question restent au propriétaire, et seul le propriétaire peut inviter ou révoquer. Pour cesser le partage, révoquez l'invitation de la personne sous Invitations dans l'onglet Personnes, ou retirez-la de votre réseau Tailscale; son travail en cours continue, et sa prochaine requête est refusée.
- Remote dispatch (
work_ledger.remote_dispatch, par défautfalse) permet à un clavardage Ultra Mode d'exécuter des tâches sur les machines que vous avez connectées sous Paramètres → Remote Crew. Rien n'est envoyé tant qu'une machine n'est pas connectée.
Ultra Mode lui-même est décrit sous Sessions.
Les identifiants des canaux se trouvent dans le coffre-fort de secrets chiffré ou dans ~/.kiro/crew/.env, pas dans config.json. Configurez-les dans Paramètres → Canaux de messagerie. Le fichier .env est lisible et modifiable uniquement par son propriétaire.
| Variable | Valeur par défaut | Objectif |
|---|---|---|
KIROCREW_HOME | ~/.kiro/crew | Répertoire de données pour la configuration, la mémoire, les journaux et les identifiants |
KIROCREW_PORT | 5476 | Port de la passerelle |
KIROCREW_CREW_LOG | activé si non défini | Définissez à 0 avant le démarrage de la passerelle pour désactiver le journal Crew caviardé et le registre de session par défaut |
Définissez-les avant de démarrer la passerelle. Utilisez --port pour remplacer KIROCREW_PORT pour une seule invocation.
L'état persistant réside sous ~/.kiro/crew/, sauf si KIROCREW_HOME pointe ailleurs. Consultez Installation pour la disposition des répertoires.
Configuration