Web

OpenCode peut s’exécuter comme une application Web dans votre navigateur, offrant la même expérience puissante de codage d’IA sans avoir besoin d’un terminal.

Commencer

Démarrez l’interface Web en exécutant :

opencode web

Cela démarre un serveur local sur 127.0.0.1 avec un port disponible aléatoire et ouvre automatiquement OpenCode dans votre navigateur par défaut.

Attention

Si OPENCODE_SERVER_PASSWORD n’est pas défini, le serveur ne sera pas sécurisé. C’est bien pour une utilisation locale mais doit être défini pour l’accès au réseau.

Windows Utilisateurs

Pour une expérience optimale, exécutez opencode web à partir de WSL plutôt que de PowerShell. Cela garantit un accès correct au système de fichiers et une intégration du terminal.

---

Configuration

Vous pouvez configurer le serveur Web à l’aide d’indicateurs de ligne de commande ou dans votre fichier de configuration.

Port

Par défaut, OpenCode sélectionne un port disponible. Vous pouvez spécifier un port :

opencode web --port 4096

Nom d’hôte

Par défaut, le serveur se lie à 127.0.0.1 (localhost uniquement). Pour rendre OpenCode accessible sur votre réseau :

opencode web --hostname 0.0.0.0

Lorsque vous utilisez 0.0.0.0, OpenCode affichera les adresses locales et réseau :

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

mDNS Découverte

Activez mDNS pour rendre votre serveur visible sur le réseau local :

opencode web --mdns

Cela définit automatiquement le nom d’hôte sur 0.0.0.0 et annonce le serveur comme opencode.local.

Vous pouvez personnaliser le nom de domaine mDNS pour exécuter plusieurs instances sur le même réseau :

opencode web --mdns --mdns-domain myproject.local

CORS

Pour autoriser des domaines supplémentaires pour CORS (utile pour les frontends personnalisés) :

opencode web --cors https://example.com

Authentification

Pour protéger l’accès, définissez un mot de passe à l’aide de la variable d’environnement OPENCODE_SERVER_PASSWORD :

OPENCODE_SERVER_PASSWORD=secret opencode web

Le nom d’utilisateur par défaut est opencode mais peut être modifié avec OPENCODE_SERVER_USERNAME.

---

Utilisation de l’interface Web

Une fois démarrée, l’interface web permet d’accéder à vos sessions OpenCode.

Séances

Consultez et gérez vos sessions depuis la page d’accueil. Vous pouvez voir les sessions actives et en démarrer de nouvelles.

Statut du serveur

Cliquez sur “Voir les serveurs” pour afficher les serveurs connectés et leur état.

---

Attacher un terminal

Vous pouvez connecter un terminal TUI à un serveur Web en cours d’exécution :

# Start the web server
opencode web --port 4096

# In another terminal, attach the TUI
opencode attach http://localhost:4096

Cela vous permet d’utiliser simultanément l’interface Web et le terminal, en partageant les mêmes sessions et le même état.

---

Fichier de configuration

Vous pouvez également configurer les paramètres du serveur dans votre fichier de configuration opencode.json :

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Les indicateurs de ligne de commande ont priorité sur les paramètres du fichier de configuration.