Prompt Share

Extension VS Code qui permet à plusieurs personnes de travailler dans un même chat IA, avec les modèles GitHub Copilot de l'hôte, en passant par sa machine. L'hôte garde la main : il valide chaque question des invités et chaque action de l'agent.

Prompt Share est un projet indépendant, non affilié à GitHub ni à Microsoft. GitHub Copilot est une marque de GitHub, Inc.

• L'extension tourne chez l'hôte. Les invités la rejoignent depuis VS Code, ou avec un simple navigateur.
• Au démarrage d'une session, elle lance un petit serveur HTTP + WebSocket sur 127.0.0.1:3717, qui sert une page de chat.
• Toutes les questions sont envoyées au modèle par l'hôte, via l'API Language Model de VS Code (vscode.lm). Les réponses sont diffusées en streaming à tous les participants.
• Comme l'agent Copilot, le modèle travaille dans le projet de l'hôte : il lit, cherche, pose des questions, modifie des fichiers et lance des commandes. Il est confiné au projet, et chaque modification ou commande est validée (par l'hôte seul dès qu'elle sort du projet).
• Les discussions apparaissent aussi dans le panneau Chat natif de VS Code chez l'hôte.

 Navigateur invité ─┐
 Navigateur invité ─┼─ tunnel (ngrok / port forwarding) ─► 127.0.0.1:3717 ─► extension ─► vscode.lm ─► Copilot
 Webview de l'hôte ─┘

Prérequis

• VS Code ≥ 1.136, sous Windows, Linux ou macOS
• Extension GitHub Copilot Chat installée et connectée chez l'hôte
• Node.js ≥ 18 (pour compiler)

Installation et lancement

npm install
npm run compile

Ouvrez ce dossier dans VS Code et appuyez sur F5 : une fenêtre « Extension Development Host » s'ouvre avec l'extension chargée.

Pour installer l'extension de façon permanente : npx @vscode/vsce package, puis Extensions : Installer depuis un VSIX….

Publier sur le Marketplace

Le Marketplace n'accepte pas les API expérimentales de VS Code : npm run package:marketplace produit un VSIX sans elles (l'intégration au panneau Chat natif est alors simplement désactivée, tout le reste fonctionne).

1. Créez un éditeur (publisher) sur https://marketplace.visualstudio.com/manage avec l'identifiant neo-schobert (ou changez le champ publisher de package.json).
2. npm run package:marketplace construit prompt-share-<version>.vsix.
3. Téléversez le fichier .vsix sur la page de gestion de l'éditeur. Les jetons Azure DevOps globaux utilisés par vsce publish cessent de fonctionner le 1er décembre 2026.

Détails, sources et points de vigilance (marques, conditions de GitHub) : docs/publication.md.

Utilisation

L'extension ajoute une icône Prompt Share dans la barre d'activité, et un bouton Prompt Share dans la barre d'état. Les deux ouvrent la vue du chat, qui propose deux choix.

Héberger une session

1. Saisissez votre pseudo et cliquez sur Héberger une session.
2. Sous Windows, l'extension propose de rouvrir le projet dans WSL (voir plus bas).
3. Le chat s'ouvre. Pour inviter, exposez le port de la session avec un tunnel (voir « Exposer le chat aux invités »), puis cliquez sur Inviter en haut du chat : collez l'URL publique du tunnel et le lien d'invitation est copié dans votre presse-papier.
4. L'icône de sortie en haut du chat arrête la session. Tous les participants sont alors déconnectés.

Garder la main sur son compte

Les questions des invités partent vers les modèles GitHub Copilot avec le compte de l'hôte, et comptent dans son quota. Les conditions de GitHub réservent un compte à une seule personne et interdisent d'exploiter ou de revendre l'accès au service. Prompt Share est donc fait pour des sessions de travail entre personnes de confiance, l'hôte présent (pair programming, revue, dépannage), pas pour partager un abonnement. Plusieurs protections l'encadrent :

• Avertissement au premier « Héberger » : il explique ce qui précède et doit être accepté une fois.
• Validation des questions des invités (activée par défaut) : une question d'invité n'est envoyée au modèle qu'après l'accord de l'hôte (Envoyer au modèle ou Refuser), depuis le chat, une notification VS Code ou le panneau Chat natif. Une question refusée n'est jamais envoyée.
• Limite horaire (60 questions d'invités par heure par défaut, pour toute la session) : au-delà, la question est refusée avec le délai d'attente. Une question explicitement acceptée par l'hôte passe même au-delà.
• Modèle imposé (par défaut) : les invités utilisent le modèle choisi par l'hôte et ne peuvent pas choisir de modèles premium.
• Transparence : sous la zone de saisie, chacun voit quel compte répond et les règles de la session. Les invités sont prévenus que leurs messages sont visibles par tous.

Les questions de l'hôte partent directement, sans validation ni limite.

La première question déclenche en général une demande de consentement de VS Code (« autoriser Prompt Share à utiliser les modèles de langage ? ») : l'hôte doit l'accepter. S'il refuse, les participants voient un message d'erreur explicite dans le chat.

Rejoindre une session

• Depuis VS Code, sans navigateur : dans la vue Prompt Share, saisissez votre pseudo, collez le lien d'invitation reçu de l'hôte et cliquez sur Rejoindre. C'est l'extension qui se connecte à la session de l'hôte, y compris à travers un tunnel ngrok gratuit (sa page d'avertissement est contournée).
• Depuis un navigateur, pour ceux qui n'ont pas VS Code : ouvrez simplement le lien d'invitation.

L'icône de sortie en haut du chat quitte la session.

Plusieurs discussions côte à côte

Dans VS Code, le bouton Ouvrir dans un onglet (en haut du chat) ouvre la discussion affichée dans un onglet d'éditeur, comme les onglets du Chat de VS Code. Ces onglets se glissent, se divisent (côte à côte ou l'un sous l'autre), et se détachent dans une nouvelle fenêtre. Chaque onglet suit une seule discussion, en temps réel, et prend son titre. On peut aussi ouvrir une discussion avec Prompt Share: Open Conversation in Editor Tab (palette, ou icône dans la barre de titre de la vue).

Vue et onglets comptent pour un seul participant. Les onglets se ferment quand on quitte la session ou quand la discussion est supprimée.

Notifications

Pendant une session, hébergée ou rejointe depuis VS Code, une notification apparaît quand une décision vous attend, avec ses boutons :

• hôte : question d'un invité à accepter (Envoyer au modèle / Refuser), action de l'agent à valider (Autoriser, Voir les modifications…) ;
• invité : action de l'agent à valider pour votre propre demande ;
• tout le monde : question de l'agent (réponses proposées, Répondre…).

Ouvrir affiche la discussion dans un onglet. Une décision prise ailleurs (chat, autre participant) fait disparaître la demande. Le nombre de décisions en attente reste visible en pastille sur l'icône Prompt Share et dans la barre d'état, même si la notification a été fermée. Le réglage promptShare.notifications passe à all pour être prévenu aussi de chaque nouvelle question et de chaque réponse à vos questions, ou à off.

Commandes

L'agent : un assistant à plusieurs, confiné au projet

Comme l'agent Copilot, le modèle explore le projet de l'hôte, pose des questions, modifie des fichiers et lance des commandes. Ses actions s'affichent en direct dans la réponse ; les actions sensibles apparaissent sous forme de carte de validation avec un aperçu (diff ou commande).

Qui valide quoi

• Une action qui reste dans le projet peut être validée par la personne qui a posé la question, ou par l'hôte.
• Une action qui sort du projet (commande hors bac à sable) ne peut être validée ou refusée que par l'hôte.
• « Autoriser pour la session » (réservé à l'hôte) valide d'office les actions suivantes de la même catégorie (modifications de fichiers, ou commandes dans le bac à sable) ; il ne s'applique jamais aux actions hors du projet.
• L'hôte peut décider depuis la page web, depuis le panneau Chat natif ou depuis la notification VS Code (avec « Voir les modifications » pour ouvrir le diff complet). La première décision l'emporte.
• Un refus est transmis au modèle, qui doit proposer une autre approche. Arrêter la réponse refuse les actions en attente.

Environnement fermé

• Tous les chemins sont vérifiés une fois les liens symboliques résolus : rien en dehors des dossiers ouverts n'est lisible, listable ou modifiable (y compris via un lien vers /etc ou un lien cassé pointant ailleurs).
• Les fichiers sensibles du projet sont invisibles pour l'agent : .git, .env*, clés (*.pem, *.key, id_rsa*…), .npmrc, .netrc, .ssh, .aws. Ajoutez vos motifs avec promptShare.protectedFiles.
• Les commandes s'exécutent dans un bac à sable bubblewrap (Linux) : seul le projet est visible et modifiable, le dossier personnel est absent, le réseau coupé, les fichiers protégés masqués. Les outils du PATH (ex. Node installé dans le dossier personnel) y sont visibles en lecture seule ; promptShare.sandboxReadOnlyPaths en ajoute d'autres.
• Sans bac à sable disponible (macOS, Windows sans WSL, Linux sans bubblewrap), toute commande est considérée comme hors du projet : seul l'hôte peut la valider.
• Les commandes hors bac à sable s'exécutent sur la machine de l'hôte (PowerShell sous Windows, /bin/sh ailleurs) ; le modèle est informé du système et du shell pour en respecter la syntaxe. Arrêter une réponse arrête la commande et tous ses sous-processus.
• Au démarrage, le canal de sortie « Prompt Share » indique le bac à sable détecté, ou ce qu'il manque pour l'activer.

Windows et WSL

Sous Windows, l'extension s'appuie sur WSL 2 pour fonctionner comme sous Linux. Au lancement de Start Session :

1. Elle cherche WSL. S'il n'est pas installé, la session démarre normalement (chaque commande de l'agent devra être validée par l'hôte) et le canal de sortie « Prompt Share » indique comment l'installer (wsl --install).
2. Si WSL est présent, elle propose de rouvrir le projet dans WSL (recommandé) ou de rester sous Windows.
3. Elle installe ce qui manque, en demandant votre accord à chaque fois :
   • bubblewrap dans la distribution (en root via wsl -u root, avec apt, dnf, zypper, pacman ou apk) ;
   • l'extension WSL de VS Code (Microsoft), si vous rouvrez dans WSL ;
   • Prompt Share elle-même dans WSL : elle est ajoutée au réglage remote.defaultExtensionsIfInstalledLocally, et VS Code l'y installe à la connexion.
4. Si vous rouvrez dans WSL, la fenêtre se recharge sur le projet (/mnt/c/…) et la session redémarre d'elle-même, chat ouvert.

Dans WSL, tout se passe exactement comme sous Linux. Si vous restez sous Windows, les commandes du bac à sable passent par wsl.exe (projet vu sous /mnt/c/…, mêmes protections), et les commandes hors du projet s'exécutent avec PowerShell, validées par l'hôte seul.

• promptShare.wslMode : ask (défaut), reopen (toujours rouvrir dans WSL), windows (toujours rester sous Windows), off (ne rien proposer).
• promptShare.wslDistro choisit la distribution (vide : celle par défaut) ; promptShare.wslSandbox: false désactive le bac à sable via WSL quand on reste sous Windows.
• WSL 1 ne permet pas bubblewrap : l'extension l'indique et donne la commande de conversion (wsl --set-version <distribution> 2).
• En mode développement (F5), l'extension ne peut pas suivre le projet dans WSL : ouvrez le dossier avec WSL: Connect to WSL puis relancez F5 depuis cette fenêtre.
• Les modules natifs compilés côté Windows (node_modules) peuvent ne pas fonctionner depuis WSL, et inversement : l'agent relance alors la commande hors du projet, avec votre validation.
• Sous Linux (ou dans WSL), si bubblewrap manque, l'extension propose de l'installer dans un terminal (sudo apt-get install bubblewrap…) ; redémarrez ensuite la session.

Panneau Chat natif

Pendant une session, les discussions apparaissent dans la liste des sessions du panneau Chat de VS Code, sous « Prompt Share ». L'hôte peut y ouvrir une discussion, relire son historique (questions des invités préfixées par leur pseudo, actions de l'agent) et poser des questions : le modèle choisi dans le sélecteur du chat natif est utilisé, et la réponse est diffusée à tous les participants. Une nouvelle session créée depuis le panneau crée une nouvelle discussion partagée.

Cette intégration utilise une API de VS Code encore expérimentale (chatSessionsProvider) :

• Avec F5 (mode développement), elle fonctionne directement.
• Avec l'extension installée (VSIX), il faut lancer VS Code avec code --enable-proposed-api local.prompt-share, ou ajouter "enable-proposed-api": ["local.prompt-share"] dans argv.json (commande Préférences : Configurer les arguments d'exécution). Sinon, l'extension fonctionne normalement sans cette intégration.
• Une mise à jour de VS Code peut modifier cette API et désactiver l'intégration ; le reste de l'extension n'est pas concerné. promptShare.nativeChat permet de la désactiver.
• VS Code charge le contenu d'une discussion une seule fois. Pour suivre l'activité des invités, l'extension rouvre l'onglet de la discussion à chaque nouvelle question, puis la réponse s'y affiche en streaming. Un onglet masqué n'est rouvert qu'au moment où il redevient visible, et jamais pendant que l'hôte attend une réponse à sa propre question. Un texte en cours de saisie dans l'onglet peut être perdu lors de la réouverture.
• Une discussion ouverte dans la barre latérale Chat (et non dans un onglet d'éditeur) ne se met pas à jour d'elle-même : l'API ne permet pas de savoir laquelle y est affichée. Rouvrez-la, ou ouvrez-la dans un éditeur (« Open as Editor »).

Exposer le chat aux invités

Le serveur n'écoute que sur 127.0.0.1 : il n'est pas accessible depuis le réseau tant que l'hôte n'ouvre pas lui-même un tunnel. L'extension ne gère pas le tunnel.

Avec ngrok

ngrok http 3717

Copiez l'URL https://….ngrok-free.app affichée par ngrok, puis lancez Copy Invite Link et collez-la.

Sur le plan gratuit, ngrok affiche une page d'avertissement à la première visite ; les invités cliquent sur « Visit Site ».

Avec le port forwarding de VS Code

1. Panneau Ports (Affichage → Ouvrir la vue… → Ports) → Transférer un port → 3717.
2. Clic droit sur le port → Visibilité du port → Public (sinon les invités doivent se connecter à GitHub avec un compte autorisé).
3. Copiez l'adresse transférée, puis Copy Invite Link et collez-la.

Partager le lien : envoyez le lien copié (il contient le token). Toute personne qui possède ce lien peut rejoindre le chat et poser des questions. Pour révoquer l'accès, arrêtez la session et redémarrez-en une : un nouveau token est généré.

Côté participants

1. Ouvrir le lien, choisir un pseudo.
2. Toutes les discussions de la session s'affichent, puis les nouveaux messages en temps réel.
3. Discussions : la colonne de gauche liste les discussions. « + Nouvelle discussion » en ouvre une nouvelle, qui prend le titre de sa première question ; le crayon ✎ la renomme. Chaque discussion a son propre historique : le modèle ne voit que celui de la discussion où la question est posée. Un badge signale les nouveaux messages dans les autres discussions, et la liste des participants indique qui est dans quelle discussion. Seul l'hôte peut supprimer une discussion (🗑, deux clics).
4. Modèle : les invités utilisent le modèle choisi par l'hôte. Si l'hôte l'autorise (allowGuestModelChoice), le menu sous la zone de saisie permet d'en choisir un autre ; ce choix est mémorisé par le navigateur.
5. Accord de l'hôte : par défaut, une question d'invité affiche « En attente de l'accord de l'hôte… » jusqu'à sa décision. Refusée, elle reste visible mais n'est jamais envoyée au modèle.
6. Les questions sont traitées une par une, dans l'ordre d'arrivée, toutes discussions confondues ; la page indique qui reçoit une réponse et la position de sa propre question dans la file.
7. En cas de coupure réseau, la page se reconnecte automatiquement avec le même pseudo et revient sur la même discussion.
8. Présence en temps réel : la liste des discussions montre les avatars des participants présents dans chacune, et « Camille écrit… » quand quelqu'un tape ; au-dessus de la zone de saisie, on voit qui est dans la discussion et qui est en train d'écrire.

Paramètres

Limites connues

• VS Code doit rester ouvert chez l'hôte pendant toute la session : c'est lui qui sert la page et interroge le modèle. Fermer la fenêtre arrête la session.
• Toutes les requêtes utilisent le compte et les quotas GitHub Copilot de l'hôte, et les conditions de GitHub s'appliquent à cet usage (voir « Garder la main sur son compte »).
• Aucune persistance : l'historique vit en mémoire et disparaît à l'arrêt de la session.
• Une seule question est traitée à la fois pour toute la session, même avec plusieurs discussions ; chaque participant peut avoir au plus 5 questions en attente.
• Si l'hôte autorise les invités à choisir leur modèle (allowGuestModelChoice), les modèles premium qu'ils choisissent sont décomptés de son quota.
• La limite horaire vaut pour toute la session et se remet à zéro au redémarrage de la session.
• Le token est la seule protection : quiconque obtient le lien peut poser des questions, et donc faire lire tout le projet par le modèle (hors fichiers protégés), et valider les modifications que l'agent propose en réponse à ses propres questions. N'invitez que des personnes de confiance, ou passez agentMode à readOnly ou off.
• Une action en attente de validation ou une question de l'agent bloque la file d'attente jusqu'à la réponse.
• Le bac à sable des commandes nécessite bubblewrap sous Linux, ou WSL 2 + bubblewrap sous Windows ; sans lui (macOS notamment), chaque commande doit être validée par l'hôte.
• Seul l'hôte peut annuler une réponse.
• Le Markdown est volontairement simple (pas de tableaux ni de coloration syntaxique).

Développement

src/
  protocol.ts        Types des messages WebSocket, partagés serveur/client
  server.ts          Serveur HTTP + WebSocket, authentification par token
  chatRoom.ts        Historique, participants, file FIFO, construction du prompt
  copilotBackend.ts  Appels à vscode.lm : sélection du modèle, boucle agent (outils), erreurs, annulation
  agentTools.ts      Outils de l'agent, confinement au projet, exécution des commandes
  sandbox.ts         Bac à sable bubblewrap : Linux natif ou via WSL sous Windows
  wslSetup.ts        Windows : détection de WSL, réouverture dans WSL, installation de ce qui manque
  nativeChat.ts      Intégration au panneau Chat natif (API proposée chatSessionsProvider)
  types/             Définitions des API proposées de VS Code utilisées
  extension.ts       Commandes, héberger / rejoindre, barre d'état
  chatView.ts        Vue du chat dans VS Code : accueil, connexion relayée vers la session
  web/               Client navigateur (TypeScript vanilla, bundlé par esbuild)
media/               index.html et style.css servis aux navigateurs
test/smoke.ts        Test de bout en bout avec un modèle simulé
test/vscode/         Tests d'intégration dans un vrai VS Code (confinement, chat natif, vue)

• npm run watch : recompilation continue
• npm run check-types : vérification TypeScript stricte (extension et client)
• npm test : lance le vrai serveur avec un modèle simulé et vérifie l'authentification, la diffusion identique à plusieurs clients, l'ordre FIFO, l'annulation, les discussions (historiques séparés, renommage, suppression), le choix du modèle, les actions d'outils, les règles de validation (auteur / hôte / hors projet), les questions de l'agent, la reconnexion et l'arrêt de session.
• npm run test:view : construit le VSIX du Marketplace et lance deux VS Code isolés ; l'un héberge une session, l'autre la rejoint depuis sa vue, sans navigateur.
• npm run test:vscode : lance un VS Code isolé (profil temporaire) sur un projet piégé (.env, .git, liens vers /etc et hors du projet) et vérifie le confinement de l'agent et du bac à sable, en mode Linux puis en mode WSL simulé (faux wsl.exe). Il vérifie aussi qu'un onglet du chat natif suit en direct les questions d'un invité. Nécessite la commande code et un affichage.