Documentation/VS Code/Installation

OrbitWake for VS Code

Installation

OrbitWake est publié sur le Visual Studio Marketplace sous l’identifiant orbitwake.orbitwake-vscode. La méthode recommandée est l’installation depuis VS Code ou le Marketplace. Un fichier VSIX peut aussi être installé lorsqu’il vous a été fourni directement.

Prérequis

La version actuelle de l’extension dans le repo est 0.1.4.

OrbitWake nécessite VS Code 1.106 ou plus récent, car l’extension utilise le point de contribution natif Secondary Side Bar.

Pour utiliser les fonctions Ask et Agent après installation, vous aurez aussi besoin d’un compte OrbitWake éligible et d’un workspace auquel l’éditeur peut être pairé.

Installer depuis le Visual Studio Marketplace

Le listing public est disponible sous le publisher orbitwake et le nom OrbitWake.

Depuis un navigateur, ouvrez la page Marketplace :

OrbitWake — Visual Studio Marketplace

Depuis VS Code :

Ouvrez la vue Extensions.
Recherchez OrbitWake.
Vérifiez que le publisher est orbitwake.
Sélectionnez l’extension OrbitWake.
Cliquez sur Install.

Installer avec Quick Open

VS Code permet aussi d’installer directement l’extension depuis Quick Open.

Ouvrez Quick Open avec Ctrl+P ou Cmd+P, puis saisissez :

ext install orbitwake.orbitwake-vscode

Validez la commande puis laissez VS Code terminer l’installation.

Installer avec la CLI VS Code

Si la commande code est disponible dans votre terminal :

$ code --install-extension orbitwake.orbitwake-vscode

Cette méthode demande à VS Code d’installer l’extension publiée correspondant à l’identifiant du Marketplace.

Vérifier l’installation

Après installation, vous devez pouvoir observer plusieurs éléments :

Vérification	Résultat attendu
Extensions	OrbitWake apparaît comme extension installée.
Secondary Side Bar	Un container OrbitWake est disponible.
Command Palette	Les commandes OrbitWake sont enregistrées.
Vue OrbitWake	Le panneau affiche son état de connexion.

Commandes disponibles après installation

La version actuelle enregistre trois commandes principales :

Commande	Usage
`OrbitWake: Connect IDE`	Pairer VS Code avec un workspace OrbitWake.
`OrbitWake: Disconnect IDE`	Supprimer la session locale de l’éditeur.
`OrbitWake: Ask About Selection`	Préremplir OrbitWake avec la sélection de code courante.

L’installation ne connecte pas automatiquement votre compte

Installer l’extension et connecter l’IDE sont deux étapes distinctes.

Après installation, ouvrez OrbitWake dans le navigateur, puis Settings → IDEs. Créez un code de pairing et utilisez ensuite OrbitWake: Connect IDE dans VS Code.

Le code de pairing est à usage unique et expire après 10 minutes.

Installation depuis un fichier VSIX

Le repo peut produire un fichier .vsix via son workflow de packaging. Cette méthode sert principalement aux builds de test, aux distributions contrôlées ou aux cas où un fichier VSIX vous a été fourni directement.

Ne téléchargez pas un VSIX depuis une source non vérifiéeUtilisez le Marketplace officiel ou un fichier transmis par une source OrbitWake de confiance. Un VSIX est du code exécutable dans l’éditeur.

Pour installer un VSIX fourni :

Ouvrez la vue Extensions.
Ouvrez le menu ….
Choisissez Install from VSIX….
Sélectionnez le fichier OrbitWake .vsix.

Vous pouvez aussi utiliser la CLI :

$ code --install-extension ./orbitwake-vscode-0.1.4.vsix

Le nom exact du fichier dépend de la version du package qui vous a été fournie.

Comment le VSIX est validé dans le repo

Le workflow Package OrbitWake VS Code Extension est déclenché pour les changements de l’extension sur les pull requests ciblant la branche release, ou manuellement.

Avant de produire le VSIX, il vérifie :

Contrôle	But
Syntaxe Node.js	Vérifier le runtime de l’extension et le script du webview.
Tests webview	Vérifier les interactions principales du panneau.
Extension Host	Lancer les tests dans un environnement VS Code sous Xvfb.
Packaging	Créer le fichier `orbitwake-vscode-<version>.vsix`.
Contenu VSIX	Vérifier runtime, webview, icône et `package.json`.

Mises à jour

Lorsque l’extension est installée depuis le Marketplace, les mises à jour suivent le mécanisme standard de VS Code selon les réglages de l’utilisateur.

Si vous avez installé un VSIX manuellement, vous devrez installer une nouvelle version du VSIX ou revenir à la version Marketplace pour recevoir les mises à jour publiées.

Vérifier la version installée

Dans la vue Extensions, ouvrez la fiche OrbitWake et consultez la version installée.

La version du repo documentée ici est 0.1.4. Si votre version est plus ancienne, certaines capacités décrites dans la documentation — comme le comportement de la Secondary Side Bar ou les corrections du contexte Ask — peuvent différer.

Si OrbitWake n’apparaît pas après installation

Vérifiez d’abord la version de VS Code. Une version antérieure à 1.106 ne satisfait pas l’exigence déclarée par le package.

Ensuite, vérifiez que l’extension est activée et qu’aucun message d’erreur d’activation n’apparaît dans VS Code.

Si vous venez d’installer ou de mettre à jour l’extension, rechargez la fenêtre VS Code avant de poursuivre le pairing.

Limites d’installation actuelles

L’installation seule ne garantit pas l’accès aux fonctions AI. Les endpoints IDE vérifient encore l’éligibilité private beta du compte dans cette build.

Le package est conçu pour VS Code et son API d’extension actuelle ; cette page ne documente pas d’autres éditeurs comme compatibles.

Le VSIX généré par CI est un artifact de build du repo. La méthode publique recommandée reste le Marketplace.

Étape suivante

Après installation, connectez l’éditeur à votre workspace OrbitWake avec un code de pairing.