Mode dev
Le mode dev sert le serveur de dev de votre poste à une adresse de while. Les membres de l’organisation l’ouvrent dans leur navigateur et y laissent leurs remarques, sans mise en ligne.
Mis à jour le 21 novembre 2026.
Vous, à votre IA : Montre ce que je suis en train de faire, sans le mettre en ligne.
Quand vous en servir
Pour montrer votre travail en cours à vos collègues ou à un client, sans le mettre en ligne : lancez npx while-sh dev.
Comment ça marche
Le mode dev sert le serveur de dev de votre poste à une adresse de while, <projet>-dev-<nom>.while.cloud. Les membres de l’organisation l’ouvrent dans leur navigateur, sans mise en ligne.
- Il faut Node 22 au moins. Si votre serveur de dev tourne déjà, lancez
npx while-sh dev --project boutique(ici,boutiqueest le slug du projet). Sinon, laissez while-sh le lancer :npx while-sh dev --project boutique -- npm run dev. - La première fois, while-sh donne une page de while et un code de connexion. Ouvrez la page et vérifiez qu’elle montre le même code.
- while-sh écrit l’adresse sur stdout. Qui entre dans l’appli du projet en production entre à cette adresse.
- À cette adresse, les pages ont un widget de remarques : un membre y pointe ce qui ne va pas. Sa remarque arrive sur votre poste en quelques secondes, sur stderr et dans
.while/remarques/<n>.md. Votre IA la lit dans ce fichier, ou par l’outil MCPlist_page_notes. - Quelqu’un qui n’a pas de compte while, un client par exemple, entre par un lien de partage. Créez-le dans Projet › Réglages › Liens, groupe « Adresses de dev ». Votre IA vous donne cette page par l’outil MCP
request_access_link { dev_address }: le lien, c’est vous qui le créez. Il dure de 1 à 7 jours.
Ce qu’il faut savoir
while-sh n’a aucune dépendance et se lance sans installation par npx. Une fois installé (npm install -g while-sh), il se lance par wh :
wh dev --project boutique
wh dev status # dans un autre terminal : les adresses servies depuis ce poste
wh dev stop [nom] # arrête toutes ces adresses, ou celle de ce nom
wh login # connecte ce poste
wh logout # oublie la connexion de ce poste
Sans —project, while-sh prend le projet si ce poste ne peut en servir qu’un ; sinon, il en donne la liste. Le port est celui de —port, sinon le premier qui écoute parmi 5173, 3000, 4321 et 8080. stdout ne reçoit qu’une ligne : l’adresse, ou avec —json l’adresse, l’hôte, le projet et le port. Le reste va sur stderr : l’état de la session, les remarques et la sortie du serveur de dev.
Avec une commande après —, while-sh la lance et attend qu’un des ports habituels écoute. Vite refuse un en-tête Host qu’il ne connaît pas. Astro, SvelteKit et Nuxt, bâtis sur Vite, font de même. Le serveur ainsi lancé reçoit donc l’adresse de dev dans __VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS, la variable que Vite lit pour ça. Un Vite lancé à part refuse l’adresse (403 « Blocked request »). while-sh dit alors quoi faire, une seule fois : relancer Vite après —, ou ajouter l’adresse à server.allowedHosts dans vite.config.
Dans l’adresse, le nom par défaut fait 4 caractères, tirés par while, toujours les mêmes pour vous sur ce projet. Avec —name, vous le choisissez : 2 à 20 caractères, lettres, chiffres et tirets, sans tiret au début ni à la fin. Un nom n’est qu’à vous, et vous en avez un nombre limité par projet. Un nom par défaut ne change que si son adresse devient celle d’une appli ou d’un projet : un autre est alors tiré. L’adresse n’est jamais indexée par les moteurs de recherche.
Les membres se connectent avec leur compte de l’organisation (son realm), comme pour une appli interne. Le rechargement à chaud (HMR, par WebSocket) passe pour eux.
La première connexion du poste suit le flux OAuth pour appareils (device flow). Le jeton reçu n’ouvre que le mode dev, dans l’organisation choisie : aucune autre permission de l’API, ni le MCP. Les jetons du poste vont dans ~/.config/while/identifiants.json (droits 0600) et se renouvellent seuls. Il faut pouvoir mettre le projet en ligne (permission project.deploy). Un projet d’essai sans compte n’a pas de mode dev.
Une session dure 12 heures, puis while-sh en rouvre une de lui-même, à la même adresse. Il reprend de même après une coupure réseau ou un redémarrage du relais de while, qui porte les requêtes de l’adresse jusqu’à votre poste. Il s’arrête et dit pourquoi dans deux cas. Dans while, vos droits, la connexion de ce poste ou le projet sont retirés, ou votre compte est désactivé. Ou bien la même adresse est servie une seconde fois, depuis ce poste ou sous votre compte. Des droits retirés, un compte désactivé ou la connexion du poste révoquée coupent la session en moins de 10 secondes.
Le relais ajoute le widget des remarques (/__while/retours.js) aux pages HTML du serveur de dev. while-sh écrit le fichier d’une remarque dans le dossier courant. Le texte du membre y est cité comme une donnée, pour que votre IA ne le prenne pas pour une consigne.
Seule la personne qui sert l’adresse crée un lien de partage, avec la permission project.configure. Le mot de passe du lien est facultatif. Le lien est actif tout de suite, sans validation, même si le projet est en production, puisque l’adresse sert le code de votre poste.
Le visiteur d’un lien arrive sans identité. Les pages passent pour lui, avec leurs ressources et les appels que leurs scripts font à l’adresse. Les WebSocket ne passent pas, donc le rechargement à chaud non plus. Un lien est révoqué quand son auteur quitte l’organisation ou n’a plus project.configure, et quand le nom par défaut de son adresse change.
while-sh ouvre aussi, sur un port local de votre poste, une base, un cache ou une appli interne d’un environnement du projet. Vous y entrez sous votre identité, avec vos droits.
wh dev database [nom] --env <env> [--project <slug>] [--port 5432] [--json] [-- <commande>]
wh dev cache <nom> --env <env> [--project <slug>] [--port 6379] [--json] [-- <commande>]
wh dev service [nom] --env <env> [--project <slug>] [--port 8000] [--json] [-- <commande>]
Ici, nom est celui de la base, du cache ou de l’appli. Pour un cache, il est obligatoire : c’est son nom dans while.yaml. Sans nom, database et service prennent la base ou l’appli par défaut.
database ouvre une base PostgreSQL de l’environnement, sous votre rôle SQL et vos droits. L’adresse écrite sur stdout contient un mot de passe local tiré pour cette session. La commande lancée après — la reçoit dans DATABASE_URL. En production, la base est en lecture seule. Elle ne s’ouvre que dans deux cas : vous êtes admin ou propriétaire et vous confirmez, ou un accès limité dans le temps vous a été attribué. Pour une base de production, while-sh s’arrête à la fin de la session et demande de relancer la commande, car l’accès à la production se confirme de nouveau.
cache ouvre un cache Valkey de l’environnement, sous votre utilisateur ACL. data.read sur l’environnement donne la lecture ; data.write donne l’écriture, hors production. L’adresse écrite sur stdout, en redis://, contient un mot de passe local. La commande lancée après — la reçoit dans REDIS_URL. KEYS est fermé : passez par SCAN.
service ouvre une appli interne de l’environnement, celle que vous ouvririez à son adresse dans votre navigateur. Elle vous reçoit sous votre identité, comme dans le navigateur. L’adresse écrite sur stdout est http://dev:<mot de passe local>@127.0.0.1:8000. La commande lancée après — la reçoit dans WHILE_SERVICE_URL. En production, seuls GET et HEAD passent.
Une personne sert 3 adresses au plus, une organisation 20. Une session accepte au plus 64 requêtes en même temps, 50 Mo par corps de requête et 5 Gio en tout.
Le journal de l’organisation dit « a relié son poste en mode dev », avec l’adresse. Il dit ensuite « a délié son poste du mode dev », avec la durée, les octets et la raison.
Les outils MCP de votre agent
Votre agent s’en occupe avec les outils list_page_notes et request_access_link.