Documentation / Agents
OpenCode et Kilo Code
Mis à jour le
OpenCode et Kilo Code (un fork d'OpenCode) sont couverts par un plugin Tokenade. Chaque agent charge automatiquement au démarrage tous les fichiers de son dossier de plugins : tokenade install n'a donc qu'à y déposer un fichier, sans modifier de configuration ni de liste d'activation. Le plugin replie les résultats d'outils (sorties de commandes, lectures de fichiers, résultats MCP) avant que le modèle les lise.
Ce que l'installation écrit
Les dossiers de plugins suivent la convention XDG sur tous les systèmes : $XDG_CONFIG_HOME s'il est défini, sinon ~/.config (sous Windows, ~ désigne %USERPROFILE%).
| Agent | Fichier du plugin | Fichier de règles |
|---|---|---|
| OpenCode | ~/.config/opencode/plugin/tokenade.ts | ~/.config/opencode/AGENTS.md |
| Kilo Code | ~/.config/kilo/plugins/tokenade.ts | ~/.kilo/rules/tokenade.md |
Les deux agents reçoivent le même plugin. Le fichier de règles apprend à l'agent les commandes tokenade (recherche dans le code, lecture de documents, recherche web…).
Les mises à jour réécrivent le fichier du plugin dès qu'une installation Tokenade y est déjà présente : les correctifs vous parviennent sans relancer l'installation. C'est la présence de tokenade.ts qui signale le plugin comme installé.
Où chaque agent range sa configuration MCP
| Agent | Linux | macOS | Windows |
|---|---|---|---|
| OpenCode | ~/.config/opencode/opencode.json | ~/Library/Application Support/opencode/opencode.json | %APPDATA%\opencode\opencode.json |
| Kilo Code | ~/.config/kilo/kilo.json | ~/Library/Application Support/kilo/kilo.json | %APPDATA%\kilo\kilo.json |
Les résultats MCP sont repliés par le plugin lui-même, comme des résultats d'outils : Tokenade ne réécrit donc pas les entrées mcp de ces fichiers.
Ce dont ils profitent
D'après la matrice de compatibilité : sorties de commandes, recherche web, résultats MCP, recherche dans le code, dédup des relectures, documents et médias, et masquage des secrets sont couverts. L'optimisation du contexte est partielle avec le plugin seul, et complète avec le proxy LLM.
tokenade install ne met en place le proxy LLM pour un agent que là où il apporte une fonction. Dans ce cas, il fait pointer le fournisseur de l'agent vers une adresse locale (127.0.0.1, port 8787 ou le suivant libre) dans ce même opencode.json / kilo.json, vérifie que le proxy répond, et remet le fichier exactement comme avant sinon. Pour l'annuler :
tokenade llm-proxy uninstall --agent kilo-code
Après l'installation
Redémarrez OpenCode ou Kilo Code pour qu'il charge le nouveau plugin. Lancez ensuite une session avec une commande bavarde.
Vérifier
Les lignes consacrées aux plugins indiquent s'ils se chargent :
-- kilo-code plugin installed but no saving was ever recorded for it — start kilo-code once; if it stays silent the bridge is not loading (shell-proxy compaction still applies)
La seconde ligne est normale juste après l'installation, avant le premier démarrage de l'agent. Si elle persiste après une vraie session, l'agent ne charge pas son dossier de plugins : vérifiez que le fichier existe et que votre version de l'agent prend en charge les plugins. Également utile :
tokenade gain --by-source # économies réparties par source
Retirer
tokenade uninstall
La désinstallation supprime les deux fichiers tokenade.ts, annule tout réglage du proxy LLM et retire les sections de règles. Pour n'installer que l'un des deux : tokenade install --only opencode ou tokenade install --only kilo-code. Voir Mettre à jour et désinstaller.