Exécutez Kiro Crew sur des hôtes de développement distants, des instances EC2, des serveurs personnels ou des tâches Fargate jetables et accédez-y depuis un seul tableau de bord local. Les instances longue durée exposent une passerelle loopback via un transfert de port SSH ou AWS SSM. Fargate expose une API de tour limitée à la tâche via AWS SSM, sans règle réseau entrante.
Activation volontaire. Désactivé par défaut.
Définissez instances.enabled à true et redémarrez la passerelle, connectez une crew sous Settings → Remote Crew, puis activez Settings → Developer → Feature Previews → Chat on a crew. Dans Kiro Crew 0.10.0 ou une version ultérieure, ce seul interrupteur ajoute New chat on crew au menu de création et affiche les sessions de chaque crew connectée dans la liste Sessions; l'interrupteur distinct Remote crew sessions de la version 0.9 a disparu, et une machine où il était activé conserve la fonctionnalité jusqu'à ce que vous désactiviez Chat on a crew. Une crew distante est une autre machine que vous avez connectée, pas l'un de vos agents.
Avec l'aperçu activé, la liste Sessions place Local en premier, puis un groupe repliable par crew connectée. Chaque en-tête de groupe porte un insigne Online, Reconnecting, Error ou Offline, de sorte que vous voyez quelles machines sont joignables avant d'ouvrir une session. Replier un groupe masque ses lignes sans changer votre sélection. Un tableau de bord sans crew connectée n'affiche aucun en-tête de groupe.
Ouvrir une session depuis un groupe de crew ouvre une fenêtre sur la propre session de cette crew. La transcription, l'état d'exécution et toute approbation en attente sont lus depuis le pair via le mandataire du hub, et chaque action (envoyer, arrêter, approuver, continuer, régénérer, revenir en arrière) appelle la propre route du pair. Rien de la session n'est stocké sur cette machine au-delà d'un cache en mémoire.
Les deux machines doivent exécuter la même version de Kiro Crew. Dans Kiro Crew 0.10.0 ou une version ultérieure, la ligne Remote Crew et l'en-tête de la fenêtre de crew affichent un insigne Behind qui nomme la version exécutée de chaque côté lorsque la crew connectée est plus ancienne, et proposent de la mettre à jour; la mise à jour exécute les propres commandes de mise à jour et de redémarrage de la crew, et elle est refusée pour une crew chaînée ou sans interface. Le propriétaire peut aussi désactiver une crew distante depuis Settings → Remote Crew.
Le comportement de connexion automatique se trouve sous Settings → Remote Crew → Auto-connect crews.
Avant la version 0.9, l'aperçu Chat on a crew exécutait chaque tour d'un clavardage local sur la crew distante sélectionnée via un relais de tour, tandis que la transcription restait sur cette machine. Ce relais n'existe plus. Un clavardage qu'une version plus ancienne a exécuté par ce relais s'ouvre toujours, en lecture seule : l'envoi, la régénération et toute autre action qui démarrerait un tour sont refusés avec un avis indiquant que le clavardage s'est exécuté sur une crew distante. Pour poursuivre ce travail, ouvrez la propre session de la crew depuis son groupe dans la liste Sessions.
kirocrew config set instances.enabled true
La passerelle lit instances.enabled au démarrage, alors redémarrez-la après avoir changé la valeur. Au redémarrage, elle crée le registre des instances et commence à gérer les connexions admissibles.
Utilisez un nom d'hôte, user@host ou un alias de configuration SSH. L'authentification doit fonctionner sans invite interactive, normalement via ssh-agent ou un fichier d'identité configuré.
Utilisez un ID d'instance EC2 ou un ID d'instance gérée SSM avec un profil AWS et une région. La machine locale nécessite l'AWS CLI et le plugin Session Manager, et l'instance distante nécessite l'agent SSM ainsi que les permissions IAM requises. La connexion utilise le transfert de port et ne nécessite pas de règle SSH entrante.
Fargate est conçu pour les travailleurs distants jetables. La crew distante s'exécute en tant que tâche ECS et est accessible via un transfert SSM vers son API de tour, sans écouteur public ni tableau de bord distant intégré. Configurez le placement Fargate, l'image épinglée par condensé et les références aux secrets dans le bloc facultatif fargate de cloud.json; la surface Cloud affiche l'état de la connexion et de la tâche.
Une tâche dure six heures par défaut. Définissez fargate.task_ttl_seconds pour choisir une durée de vie positive différente. Le moteur d'exécution admet au plus dix tâches Crew Fargate à la fois; ce plafond de sécurité est fixe plutôt qu'un paramètre de cloud.json.
L'ordinateur portable qui se connecte nécessite l'AWS CLI et le plugin Session Manager. Fargate utilise les mêmes contrôles de crew distante réservés au propriétaire que les autres méthodes de connexion.
Avec instances.enabled activé, le formulaire de lancement EC2 intégré sous Settings → Remote Crew accepte un Subnet ID facultatif. En fournir un place la crew dans ce sous-réseau et son VPC. Kiro Crew vérifie la présence d'une route NAT ou de passerelle Internet avant le lancement et s'arrête en nommant la route manquante lorsque le sous-réseau n'a pas de sortie Internet.
┌── Hub gateway (this host) ──┐ │ /instances page (React) │ │ ├─ tab strip: Home · A · B │ │ ├─ warm <iframe>s per tab │ http://127.0.0.1:<local_port>/?token=… │ └─ Manage panel │ add / connect / diagnose / restart / remove │ │ │ instances/ package │ │ ├─ registry │ ~/.kiro/crew/instances.json │ ├─ port_allocator │ loopback ports from base 7778 │ ├─ token_mint │ ssh <host> kirocrew token → JWT (never logged) │ ├─ ssh_tunnel_manager │ supervised ssh -N -L, probe, self-heal, refresh │ └─ diagnostics │ ssh → remote-dashboard → local-forward ladder └──────────────────────────────┘ │ ssh -N -L 127.0.0.1:<local>:127.0.0.1:<remote> ▼ ┌── Remote gateway ────────────┐ │ kirocrew gateway bound to │ │ 127.0.0.1:<remote_port> │ └──────────────────────────────┘
Chaque instance que vous ajoutez produit un processus enfant supervisé ssh -N -L. Le tunnel transfère 127.0.0.1:<local> → distant 127.0.0.1:<remote>. Le hub émet un jeton de tableau de bord sur l'instance distante via SSH et intègre le tableau de bord distant dans un iframe à l'URL loopback.
- Connexion —
POST /api/instances/{id}/connectalloue un port loopback, émet un jeton sur l'instance distante via SSH, démarressh -N -L, attend que le transfert local accepte une connexion, puis renvoie l'état en direct - Ensemble actif — par défaut, l'ensemble actif s'ajuste automatiquement pour les instances admissibles, avec un plafond de 8; définissez
instances.warm_set_capsur une valeur positive pour fixer une limite. Les instances actives conservent un tunnel + WebSocket en direct. Se connecter au-delà du plafond évince paresseusement la moins récemment utilisée - Sonde de santé — pendant la connexion, une sonde interroge le transfert loopback toutes les 30 s; après 3 échecs consécutifs, elle arrête le processus enfant pour déclencher la récupération
- Autoréparation à 2 niveaux — en cas d'arrêt inattendu : le niveau 1 reconstruit le tunnel en réutilisant le jeton existant; le niveau 2 réémet le jeton puis reconstruit. Limité à 8 tentatives avec un délai exponentiel plafonné (fenêtre d'environ 2 min)
- Renouvellement proactif du jeton — une boucle par instance réémet le jeton à 0,8 de sa durée de vie (TTL), avant le plafond d'environ 20 h
- Diagnostic / redémarrage —
?diagnose=1exécute une série de sondes de défaillance à la demande;POST .../restartredémarre la passerelle distante via SSH
Ouvrez Settings → Remote Crew, sélectionnez Add remote crew et choisissez la méthode de connexion.
| Méthode | Champs cibles |
|---|---|
| SSH | Nom d'hôte, user@host ou alias de configuration SSH, plus le port de la passerelle distante |
| AWS SSM | ID d'instance EC2 (i-*) ou ID d'instance gérée (mi-*), profil AWS, région et utilisateur d'exécution facultatif |
| Fargate | La cible de tâche ECS enregistrée créée par le flux de lancement Cloud, plus le profil AWS et la région |
Toutes les méthodes prennent un nom d'affichage. Les passerelles SSH et SSM longue durée utilisent également une durée de vie du jeton de tableau de bord. Une valeur commençant par - ou une cible qui ne correspond pas à sa méthode est refusée avant le démarrage d'un processus enfant.
Utilisez votre alias de configuration SSH ou user@hostname. L'authentification doit réussir de façon non interactive via ssh-agent ou des clés configurées.
Configurez un alias SSH sur le hub, puis utilisez cet alias comme cible SSH :
Host my-ec2 HostName ec2-1-2-3-4.compute-1.amazonaws.com User ec2-user IdentityFile ~/.ssh/my-key.pem ProxyJump bastion-host
Pour une instance EC2 sans port SSH entrant, choisissez AWS SSM directement ou utilisez une ProxyCommand SSM dans l'alias SSH.
Prérequis sur le hub :
- Une clé sans phrase de passe ou un
ssh-agentla détenant (BatchModene demandera pas d'invite) kirocrewinstallé et une passerelle en cours d'exécution sur le port loopback de l'instance EC2
| Besoin | État | Comment |
|---|---|---|
| Utilisateur de connexion personnalisé | ✅ | user@host ou User dans la configuration ssh |
| FQDN / IP | ✅ | valeur directe de ssh_host |
Fichier d'identité (-i) | ⚠️ via la configuration ssh seulement | IdentityFile dans un bloc Host |
| Port SSH autre que 22 | ⚠️ via la configuration ssh seulement | Port dans un bloc Host |
| Bastion / ProxyJump | ⚠️ via la configuration ssh seulement | ProxyJump / ProxyCommand |
| Instances SSM uniquement | ⚠️ via la configuration ssh seulement | ProxyCommand avec aws ssm start-session |
Un tableau de bord distant peut exposer ses propres crews distantes. Lorsque vous en connectez une dans ce panneau, votre tableau de bord local l'adopte comme onglet de premier niveau dans le sélecteur. L'onglet est indenté sous la crew parente dont le tunnel SSH le transporte, et il devient indisponible lorsque ce parent est hors service.
Une chaîne prend en charge deux sauts, de votre tableau de bord à une autre crew en passant par une crew connectée en SSH. Un parent peut transporter au plus huit crews chaînées. Retirer le parent retire ses entrées chaînées de votre tableau de bord.
Le panneau Manage vous offre les actions suivantes par instance :
- Connect — ouvrir un tunnel + iframe
- Disconnect — fermer le tunnel
- Diagnose — exécuter la série de sondes de défaillance et signaler le premier lien rompu
- Restart — redémarrer la passerelle distante via SSH (avec prise en compte du service)
- Edit — modifier le nom / l'hôte / le port / le TTL
- Remove — déconnecter puis supprimer
Chaque route de /api/instances/* est protégée par _guard() :
- Refus par défaut — rejette les requêtes provenant de Slack (403)
- Réservé au propriétaire — exige
request["user"](session de tableau de bord authentifiée) - Contrôlé par fonctionnalité — exige
instances.enabled: true - Audité par SEL — chaque appel (réussite et refus) émet un événement d'audit
Au-delà de la protection :
- Transferts loopback uniquement —
ssh -N -L 127.0.0.1:<local>:127.0.0.1:<remote> - Aucun shell local —
sshest toujours invoqué avec une liste argv;ssh_hostne peut pas injecter de syntaxe shell locale - Entrées validées par jeu de caractères —
ssh_hostetremote_binsont rejetés s'ils contiennent des métacaractères shell ou commencent par- - Jetons de courte durée — ≤20 h, renvoyés uniquement en mémoire à l'appelant, jamais journalisés, jamais dans les charges utiles de liste/état
- Vérification de l'origine postMessage — le parent valide chaque
event.originde trame intégrée par rapport à l'exacthttp://127.0.0.1:<port>d'un tunnel actuellement actif avant de faire confiance à un message de compte de non-lus
Pour instances.enabled et les autres paramètres des instances multiples, consultez Configuration.
| Symptôme | Solution |
|---|---|
/instances affiche « multi-instance management is off » | instances.enabled est à false — activez-le et redémarrez |
| L'iframe est vide | L'assouplissement de la CSP frame-src ne s'applique qu'aux ports de tunnel actifs; assurez-vous que l'instance est connectée |
| La connexion échoue avec une erreur d'authentification SSH | Actualisez vos identifiants SSH (rajoutez la clé à ssh-agent); les tunnels s'autoréparent une fois SSH rétabli |
| La connexion échoue | Utilisez Diagnose — la série de sondes signale le premier lien rompu (ssh_unreachable, remote_down ou tunnel_down) |
| L'instance se déconnecte constamment | Sonde de santé + nouvelle tentative d'autoréparation à 2 niveaux sur environ 2 min; si elle abandonne, le diagnostic s'exécute automatiquement. Vérifiez la passerelle distante et la stabilité SSH |
| Une instance a disparu silencieusement de l'ensemble actif | Évincée par LRU (ensemble actif plein). Augmentez instances.warm_set_cap ou reconnectez-vous à la demande |
Multi-instance