Ligne de commande Windows

L’installation d’AirCode Ø sur Windows ajoute la commande aircode à PowerShell et à l’invite de commandes. Elle utilise Node.js et ConPTY déjà intégrés à l’application de bureau. Vous n’avez besoin ni de WSL ni d’une autre installation de Node.js.

Après une installation ou une mise à jour, ouvrez un nouveau terminal pour charger le PATH de l’utilisateur, puis vérifiez la commande :

aircode version
aircode serve --help

La CLI d’AirCode Ø utilise le dossier choisi lors de l’installation, même si vous avez modifié son emplacement par défaut.

Application de bureau ou commande serveur ?

Votre objectif	Action
Relier une fenêtre Electron à un serveur local ou distant	Ouvrez l’application de bureau AirCode Ø
Utiliser le serveur local depuis Electron	Ouvrez l’application de bureau et choisissez Exécuter sur cette machine
Démarrer un serveur sans fenêtre Electron	Ouvrez un terminal et lancez `aircode serve`

L’exécutable de bureau ouvre toujours Electron : l’option --serve ne permet pas de l’utiliser comme serveur autonome. La CLI aircode d’AirCode Ø réutilise Node.js et le serveur installés avec l’application, mais lance son propre processus au premier plan. Consultez les modes de fonctionnement de l’application de bureau.

Démarrer un serveur

serve est la commande par défaut. Ces deux lignes ont le même effet :

aircode serve --projects-root "D:\Projects"
aircode --projects-root "D:\Projects"

Le serveur reste au premier plan et affiche ses journaux dans le terminal. Appuyez sur Ctrl+C pour l’arrêter proprement. Chaque dossier de projets dispose de ses propres données d’exécution et sessions. Si le port préféré est occupé par un autre dossier, AirCode Ø choisit automatiquement le prochain port libre.

Options de la commande serve

Option	Valeur par défaut	Fonction et réglage équivalent
`--projects-root <dir>`	Dossier courant	Dossier dont les sous-dossiers deviennent des projets. Il doit déjà exister. Variable : `AIRCODE_PROJECTS_ROOT` ; JSON : `projectsRoot`
`--host <address>`	Adresse IP Tailscale, sinon `127.0.0.1`	Interface réseau d’écoute du serveur HTTP. Variable : `AIRCODE_HOST` ; JSON : `host`
`--port <number>`	`7860`	Port HTTP de 1 à 65535. Un port explicitement demandé mais occupé provoque une erreur. Variable : `AIRCODE_PORT` ; JSON : `port`
`--public-url <url>`	Aucune	URL HTTP(S) utilisée dans les liens et les notifications. Variable : `AIRCODE_PUBLIC_URL` ; JSON : `publicUrl`
`--config <file>`	Fichier de configuration de l’utilisateur	Autre fichier de configuration JSON. Variable : `AIRCODE_CONFIG`
`--state-dir <dir>`	Dossier de données de l’utilisateur	Autre dossier pour les données d’exécution. Variable : `AIRCODE_STATE_DIR`
`--password <value>`	Généré ou déjà configuré	Mot de passe de ce processus. Pratique, mais visible dans l’historique du terminal et parfois dans la liste des processus. Variable : `AIRCODE_AUTH_PASSWORD` ; JSON : `authPassword`
`--password-file <file>`	Aucun	Lit le mot de passe dans un fichier privé
`--no-password`	Désactivé	Désactive explicitement l’authentification ; à réserver à une interface de confiance
`-h`, `--help`	—	Affiche l’aide sans démarrer le serveur

Sous Windows, le fichier de configuration habituel est %USERPROFILE%\.config\aircode\config.json. Les données d’exécution sont placées, par dossier de projets, sous %USERPROFILE%\.local\state\aircode\instances.

Mettez les chemins contenant des espaces entre guillemets. Les formes --option value et --option=value sont toutes deux acceptées. Les options de la commande priment sur les variables d’environnement, puis sur config.json et enfin sur les valeurs par défaut.

Au premier lancement, AirCode Ø génère un mot de passe, l’enregistre dans le fichier de configuration choisi et ne l’affiche qu’une fois. L’option --password permet une configuration entièrement automatisée, mais peut exposer sa valeur dans l’historique du terminal ou la liste des processus. Préférez --password-file, un fichier de configuration protégé ou une variable AIRCODE_AUTH_PASSWORD transmise de manière sécurisée. Pour désactiver l’authentification, il faut demander explicitement --no-password.

Exemples

Deux dossiers de projets simultanément

Dans un premier terminal :

cd "$HOME\Desktop"
aircode

Puis dans un second terminal :

cd "$HOME\Documents"
aircode

Si Tailscale a attribué l’adresse 100.84.12.30 à la machine, les deux instances peuvent annoncer http://100.84.12.30:7860 et http://100.84.12.30:7861. Elles ne partagent ni leurs données d’exécution ni leurs sessions. Si vous relancez aircode dans un dossier déjà actif, la commande affiche son URL au lieu de créer un doublon.

Accès depuis la machine locale seulement

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860

Ouvrez http://127.0.0.1:7860.

Tailscale ou VPN privé

Indiquez l’adresse VPN exacte attribuée à la machine Windows :

aircode serve `
  --projects-root "D:\Projects" `
  --host 100.84.12.30 `
  --port 7860

Les autres appareils du même réseau privé peuvent alors ouvrir http://100.84.12.30:7860. Préférez l’adresse VPN exacte à 0.0.0.0.

Réseau local

aircode serve `
  --projects-root "D:\Projects" `
  --host 192.168.1.25 `
  --port 7860

Le pare-feu Windows peut demander l’autorisation d’ouvrir la connexion. Autorisez uniquement les profils réseau voulus.

URL d’un proxy inverse ou d’un tunnel

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860 `
  --public-url "https://aircode.example.com"

--public-url indique seulement l’adresse à utiliser dans les liens générés. Cette option n’ouvre aucun port dans le pare-feu, ne démarre pas de proxy inverse et ne crée pas de tunnel. Consultez l’accès distant pour le tunnel sortant intégré, Tailscale et les réseaux privés.

Configuration et données séparées

aircode serve `
  --projects-root "D:\Projects" `
  --config "D:\AirCodeData\config.json" `
  --state-dir "D:\AirCodeData\state"

Pour gérer cette instance depuis un autre terminal, indiquez d’abord le même dossier de données :

$env:AIRCODE_STATE_DIR = "D:\AirCodeData\state"
aircode status
aircode stop

Utilisation avec l’application de bureau

Le serveur lancé par la CLI AirCode Ø au premier plan et celui géré par l’application de bureau sont deux processus distincts. aircode status et aircode stop concernent seulement le serveur du terminal. Pour libérer l’adresse et le port utilisés par l’application de bureau, quittez AirCode Ø depuis son icône de la zone de notification : fermer la fenêtre ne suffit pas. Vous pouvez aussi attribuer un autre port au serveur du terminal.

Un serveur lancé depuis le terminal rend accessibles l’application Web AirCode Ø et son API authentifiée. Il ne publie pas les fichiers du dossier de projets : le serveur limite l’accès aux projets situés sous projectsRoot.

Autres réglages

Les chemins des agents, les limites de sessions, les fonctions du navigateur, la base de connaissances, l’orchestration, les notifications et l’optimisation des tokens restent configurables par variables d’environnement et dans config.json. Consultez la configuration pour connaître l’ordre de priorité et les principaux réglages.