OpenCode 2.0 : l'agent de code refondu, ce qui change

OpenCode 2.0 est une refonte majeure de l’agent de code OpenCode, construite à partir de l’usage de millions d’utilisateurs quotidiens. Un seul service tourne désormais en arrière-plan, les sous-agents et les commandes shell passent en tâche de fond, et un mode code laisse l’agent piloter des outils par script. La mise à jour a un prix : les plugins de la version 1.0 ne fonctionnent plus.

En bref

• Un seul service en arrière-plan sert le terminal, le web et l’app desktop.
• Sous-agents et commandes shell peuvent tourner en tâche de fond.
• Le mode code relie des serveurs MCP via des scripts JavaScript.
• Les plugins 1.0 ne fonctionnent plus en 2.0.
• Le CLI se met à jour avec opencode upgrade --major.

Un service unique pour tous les écrans d’OpenCode 2.0

OpenCode reposait déjà sur un modèle client/serveur, mais il n’en tirait pas parti par défaut : seuls les utilisateurs avancés s’en servaient. Dans la version 2.0, le serveur tourne automatiquement comme un unique processus en arrière-plan sur ta machine. Le terminal (TUI), l’interface web et l’application desktop parlent tous à ce même processus.

Les scripts écrits avec le client @opencode/client repèrent le service local tout seul. L’annonce souligne que c’est utile pour les tâches planifiées. Le service s’appelle aussi en ligne de commande avec opencode api, ou s’expose à d’autres machines puis se relie à d’autres applications avec /pair ou opencode pair. Des applications natives qui exploitent ce fonctionnement sont en préparation.

Une API réécrite, que l’agent connaît

Selon l’équipe, l’ancienne API a grandi sans plan, au fil de ce que le monde apprenait sur les agents, et elle était mauvaise. Elle a été reprise de zéro en examinant les cas d’usage atypiques des utilisateurs, et prend désormais en charge presque tout ce qu’on peut vouloir faire.

OpenCode connaît aussi sa propre API et l’appelle de lui-même. Exemple donné : déplacer la session en cours dans un worktree git (un répertoire de travail séparé) quand tu démarres un nouveau chantier. Un paquet @opencode/client fournit des clients pour JavaScript classique et pour Effect.

Le mode code d’OpenCode 2.0 pour les serveurs MCP

Les modèles aiment écrire du code, et OpenCode 2.0 s’en sert davantage, selon l’équipe, que tout autre agent de code. Le paquet @opencode/codemode contient un interpréteur JavaScript minimal. Il ingère des serveurs MCP ou des points d’accès OpenAPI et les convertit en fonctions que l’agent appelle dans un script, sans passer par les machines virtuelles de Node.js ni intégrer une solution comme QuickJS.

L’agent peut ainsi appeler un outil, parcourir les résultats puis appeler un autre outil en un seul aller-retour, au lieu d’enchaîner les appels un par un. Tous les serveurs MCP de la 2.0 sont inscrits par défaut dans ce mode. D’après l’annonce, on peut en ajouter un millier avec peu d’encombrement du contexte, l’agent les découvrant et les combinant lui-même.

Lancer des tâches en arrière-plan et plusieurs sous-agents

Les sous-agents peuvent maintenant tourner en arrière-plan : l’agent principal confie une tâche à un autre agent et continue de son côté. Cela se déclenche automatiquement, mais tu peux aussi le demander, même avec un modèle différent. L’exemple de l’annonce : demander de lancer un sous-agent en arrière-plan pour relire le code, pendant que tu continues à écrire.

Les commandes shell sont aussi asynchrones. Un travail long ne bloque plus l’agent principal, qui est prévenu à la fin. Si une commande ou un sous-agent au premier plan dure trop, un raccourci (ctrl b dans l’exemple montré) le déplace en arrière-plan.

Plugins et SDK pour créer son propre agent

Le système de plugins de la 1.0 n’avait pas reçu l’attention nécessaire. Pour y remédier, l’équipe a implémenté presque toutes les fonctions de la 2.0 comme des plugins internes : il y en a plus de 80, ce qui oblige à maintenir l’API. Les plugins TUI passent d’expérimentaux à stables, et tout peut être rechargé à chaud : OpenCode peut écrire un plugin pour lui-même en cours de session et l’utiliser aussitôt.

Le paquet @opencode/sdk permet aussi d’employer OpenCode comme bibliothèque. C’est le code même du CLI, que tu peux alléger pour bâtir ta version sur un serveur ou dans des environnements spécialisés comme les Durable Objects. Elle reste joignable depuis n’importe quel client OpenCode, car elle parle le protocole serveur standard. Une API optionnelle basée sur Effect existe, encore en développement.

Passer à OpenCode 2.0 : mise à jour et ruptures

Pour mettre le CLI à jour, il faut d’abord être sur la dernière version 1.x, puis lancer la commande ci-dessous. L’application desktop se met à jour en téléchargeant la dernière version.

Trois changements cassent la compatibilité. Beaucoup d’autres changements restent rétrocompatibles. L’équipe conseille de montrer sa documentation de migration à OpenCode pour qu’il adapte la configuration à ta place.

• Les plugins 1.0 ne fonctionnent pas en 2.0.
• L’API du serveur est entièrement différente.
• La configuration tui.json passe au format json.

opencode upgrade --major

Quelques repères

• MCP : Protocole qui permet à un agent IA de se brancher à des outils et services externes de façon standardisée. Chaque serveur MCP expose des fonctions que l’agent peut appeler.
• Sous-agent : Agent secondaire à qui l’agent principal confie une tâche précise. Il travaille à part, puis rend son résultat.
• Worktree git : Copie de travail supplémentaire d’un même dépôt git, dans un autre dossier. Elle permet de mener plusieurs chantiers en parallèle sans les mélanger.

Questions fréquentes

Qu’est-ce qu’OpenCode 2.0 ?

OpenCode 2.0 est une refonte majeure de l’agent de code OpenCode. Elle apporte un service unique en arrière-plan, des sous-agents et commandes shell en tâche de fond, un mode code pour les serveurs MCP, des plugins et un SDK.

Comment mettre à jour OpenCode vers la version 2.0 ?

Il faut être sur la dernière version 1.x du CLI, puis lancer opencode upgrade --major. Pour l’application desktop, il suffit de télécharger la dernière version.

Les plugins OpenCode 1.0 fonctionnent-ils avec OpenCode 2.0 ?

Non, les plugins 1.0 ne marchent pas en 2.0. L’API du serveur est aussi entièrement différente, et la configuration tui.json passe au format json.

OpenCode 2.0 peut-il lancer des tâches en arrière-plan ?

Oui. Les sous-agents et les commandes shell peuvent tourner en arrière-plan pendant que tu continues à écrire, et un raccourci permet d’y déplacer un travail déjà lancé.

À retenir

OpenCode 2.0 regroupe terminal, web et desktop autour d’un service unique, et ajoute tâches de fond, mode code pour MCP, plugins et SDK. Le passage impose de refaire les plugins 1.0 et d’adapter l’API serveur et tui.json.