npm i -g hotcell

C'est la fonction autour de laquelle hotcell a été construit, et c'est vraiment de la sécurité des clés API par conception. Au lieu de copier une vraie clé API dans chaque sandbox, la passerelle détient la clé et remet à chaque cellule un jeton éphémère par cellule. Quand un agent appelle un LLM, la requête passe par la passerelle, qui échange le jeton contre la vraie clé. Si un sandbox est compromis, l'attaquant obtient un jeton qui expire, pas votre clé OpenRouter ou OpenAI. Grande différence.

hotcell create -n 5 lance cinq conteneurs distincts à partir d'une seule commande. Chaque cellule obtient sa propre branche, et vous pouvez suivre la progression en direct de chaque cellule pendant leur provisionnement. Comme la progression est signalée par cellule, une installation lente ne déclenche pas un faux dépassement de délai comme le ferait un unique délai global. C'est un petit détail. Il évite de vrais soucis.

Quand vous activez --egress, l'origin git de chaque cellule est câblé automatiquement via la passerelle. Cela veut dire que git push fonctionne sans qu'un jeton GitHub n'entre jamais dans le sandbox. L'option implique aussi le routage par la passerelle pour les appels LLM, donc un seul réglage couvre les deux identifiants. Une option, deux problèmes réglés.

Ajouter --opencode à une commande de création installe OpenCode dans chaque cellule et le pointe vers la passerelle, et cette option implique aussi --egress. Pour les équipes qui exécutent le même agent de code sur de nombreuses tâches, cela supprime une étape d'installation manuelle à chaque nouvelle cellule.

La commande hotcell run crée une cellule, exécute votre commande dedans, et détruit la cellule quand la commande se termine. Elle est utile pour des vérifications jetables comme un passage de linter, où vous ne voulez pas qu'un conteneur subsiste après.

L'interface du terminal montre toutes les cellules actives à la fois, avec l'usage mémoire en direct et une estimation du coût par cellule. Quel agent accapare les ressources ? Vous le voyez avant qu'une cellule n'affame les autres. Si vous exécutez cinq agents sur une machine, cette visibilité compte plus que n'importe quel chiffre de benchmark isolé.

hotcell keys import .env lit un fichier d'environnement standard et associe les variables aux fournisseurs, donc OPENAI_API_KEY devient automatiquement le fournisseur openai. Cela vous évite d'ajouter les clés une par une lors de la première configuration d'un hôte. La configuration reste rapide. C'est le but.