The Companion : une interface web pour piloter Claude Code et Codex

https://www.thecompanion.sh

https://github.com/The-Vibe-Company/companion

📌 The Companion est une interface web pour utiliser Claude Code et Codex dans un navigateur, avec sessions multiples, streaming en temps réel, visualisation des appels d’outils et contrôle des permissions sensibles.

Le positionnement est très clair: au lieu de jongler entre plusieurs terminaux et logs CLI, The Companion centralise l’exécution des agents dans une UI plus lisible, plus contrôlable et plus pratique au quotidien. C’est une couche d’orchestration d’usage au-dessus des CLIs, pas un remplacement des moteurs eux-mêmes.

Le site officiel insiste sur la promesse “no API key needed” dans le sens où l’outil s’appuie sur les CLIs installés localement (Claude Code et/ou Codex), tandis que le dépôt GitHub détaille une architecture en bridge WebSocket entre le navigateur, le serveur Companion et les sessions CLI.

Un point fort du projet est la visibilité opérationnelle: on peut suivre le flux de réponses, voir les tool calls et leurs résultats, puis gérer les actions sensibles via un mécanisme d’approbation explicite. Cela répond à une vraie friction des workflows agentiques en terminal, surtout quand plusieurs sessions tournent en parallèle.

• 🌐 Interface web pour Claude Code et Codex
• 🔄 Sessions parallèles sans jongler entre terminaux
• 👀 Visualisation des tool calls et résultats dans une timeline
• ✅ Contrôle des permissions (approve/deny) pour actions risquées
• ♻️ Récupération de session après redémarrage
• 🧩 Support dual-engine (Claude Code + Codex)

Le README montre un démarrage rapide assez simple: bunx the-companion, puis ouverture sur http://localhost:3456. Il est aussi possible de l’installer globalement et de l’enregistrer comme service de fond (launchd sur macOS, systemd sur Linux), ce qui est intéressant pour un usage récurrent.

L’outil expose plusieurs commandes CLI pour gérer le cycle de vie du service (install, start, stop, restart, status, logs) et permet aussi de personnaliser le port. Cette couche d’exploitation rend le projet plus mature qu’un simple prototype UI local.

Côté architecture, le dépôt documente un pont entre le frontend (React), un serveur Companion (Bun + Hono) et les CLIs via WebSocket/NDJSON. Cette transparence sur le protocole et les choix techniques est un bon signal pour comprendre, auditer ou étendre le fonctionnement.

Le projet semble aussi pensé pour un usage mobile/web plus large (d’après la description GitHub), avec un accent sur le pilotage des sessions, la lecture des sorties et l’approbation d’actions depuis une interface accessible partout sur le réseau local ou un setup dédié.

Pour quelqu’un qui travaille déjà avec des agents CLI, The Companion peut surtout améliorer le confort, la supervision et la continuité d’usage. La valeur ne vient pas d’un “nouveau modèle”, mais d’une meilleure expérience de pilotage des modèles déjà en place.

À retenir : The Companion transforme un workflow agentique terminal en expérience plus visuelle et contrôlable, tout en restant proche des CLIs Claude Code et Codex existants.