Machines

Une machine est un ordinateur relié à un serveur Stib. Les cartes qui tournent dessus utilisent sa copie du projet, et soit un abonnement de Stib, soit le compte déjà connecté sur l’ordinateur (Claude Code, Codex, Antigravity…). Le serveur envoie le travail, la machine l’exécute.

Une carte a deux réglages indépendants : sa Machine (où elle tourne) et son Identifiant (quel abonnement paie).

Les machines demandent le plan Max.

Deux sortes de machines

• Machine personnelle — ajoutée par un membre pour son propre ordinateur. Seul son propriétaire y lance un tour ; les autres membres du projet voient les cartes qui y tournent, les suivent et les commentent, mais ne lancent rien sur l’ordinateur de quelqu’un d’autre.
• Machine serveur — ajoutée par un admin, pour un ordinateur partagé. Tous les membres du projet peuvent y lancer leurs cartes.

Quel abonnement sur une machine

• Machine serveur — elle reçoit l’identifiant du serveur que la carte résout, comme sur le serveur. Un admin peut aussi y autoriser le Compte de la machine (détail de la machine › Autoriser le compte de la machine) : une carte peut alors le choisir dans sa ligne Identifiant, et tourner sur le compte connecté sur l’ordinateur.
• Machine personnelle — elle reçoit votre clé API quand la carte la choisit, ou quand c’est votre identifiant par défaut ; sinon, elle tourne sur le compte connecté sur l’ordinateur. Un identifiant serveur ne lui est jamais envoyé, ni pour l’instant un abonnement (OAuth). Le CLI Stib de l’ordinateur doit être à jour.

Le Compte de la machine se choisit carte par carte, pas sur un projet ni une organisation. Choisir un identifiant sur la carte le remplace ; une carte ramenée sur le serveur, ou sur une machine qui ne l’autorise pas, revient à l’identifiant hérité.

L’identifiant envoyé est rangé sur la machine dans un dossier propre à chaque carte, à l’écart des connexions de l’utilisateur de l’ordinateur. Quand aucun abonnement ne convient, la carte attend qu’un abonnement convienne, sans échouer.

Ajouter une machine

1. Dans Réglages › Identifiants, ajoutez un identifiant de type Machine, nommez-le (c’est le nom que vous et vos collègues verrez sur les cartes), puis Ajouter et appairer.

2. Stib affiche une commande avec un code d’appairage, valable quelques minutes. Sur l’ordinateur à relier, installez le CLI Stib puis lancez-la :

   stib host pair https://stib.example.com --code ABCD-1234

   Une adresse sans https:// est prise en HTTPS. Un serveur joint en HTTP en clair (sur votre réseau local) demande --insecure.

3. La page avance seule quand la machine se connecte. Vérifiez que l’empreinte affichée est la même que celle que donne stib host status sur l’ordinateur, puis Confirmer. « Ce n’est pas ma machine » oublie l’appairage : le secret de la machine cesse aussitôt de fonctionner.

4. Gardez la machine connectée :

   stib host serve              # au premier plan
   stib host install-service    # ou au démarrage de votre session

Tant qu’elle n’est pas confirmée, une machine ne lance rien. Appairer à nouveau remplace son secret et redemande la confirmation.

Ajouter un projet à la machine

Une machine démarre sans aucun projet. Dans le détail de la machine, Projets sur cette machine › Ajouter un projet, puis choisissez son dossier sur la machine : vous parcourez alors le disque de l’ordinateur, pas celui du serveur. Le dossier est comparé au dépôt du projet ; un dépôt différent est gardé mais signalé. Si le projet n’y est pas encore, Cloner le dépôt le clone avec les identifiants git de la machine.

Seuls les projets ajoutés peuvent tourner sur la machine. Retirer un projet laisse son dossier sur le disque.

Accès Git

La machine joint elle-même le dépôt du projet, pour le cloner et pour pousser les branches des cartes. Paramètres du projet › Git › Accès au dépôt teste chaque ordinateur qui fait tourner le projet — le serveur et chaque machine — et dit s’il peut lire et écrire. Là où la configuration git de l’ordinateur est refusée, Créer une clé crée sur cet ordinateur une clé propre à ce projet : copiez sa partie publique dans les clés de déploiement du dépôt (avec l’écriture), puis Vérifier l’accès. La partie privée ne quitte jamais l’ordinateur. Un clone refusé propose la même clé, puis le même clone.

Faire tourner une carte sur la machine

Choisissez la machine dans la ligne Machine des réglages IA de la carte, ou comme machine par défaut d’un projet, d’une organisation ou du serveur (une machine serveur seulement). Une machine personnelle peut être votre défaut personnel : dans Réglages › Identifiants, Utiliser par défaut pour mes cartes sur la machine. Vos nouvelles cartes y démarrent alors, dans les projets ajoutés à la machine. Une carte qui importe une conversation ou reprend une worktree démarre sur le serveur, où elles se trouvent. La pastille de la carte porte l’icône de la machine en coin, rouge quand elle est hors ligne. L’en-tête de la carte nomme alors la machine, et son propriétaire quand ce n’est pas vous ; Réglages › Cartes › En-tête › Machine règle cette mention.

• Machine hors ligne ou projet absent de la machine : la carte attend, jusqu’à 30 minutes, et repart seule dès que la machine peut la prendre. Le bandeau du fil propose d’ajouter le projet à la machine ou de lancer la carte ailleurs. Au bout de l’attente, la carte passe en erreur et dit ce qu’elle a attendu ; Renvoyer relance le même message.
• Worktree : une carte avec worktree a le sien sur la machine, créé au premier lancement et retrouvé ensuite.
• Panneau Git : diff, historique, stage, commit, push et pull request travaillent dans le dépôt de la machine. Sur une machine personnelle, seul son propriétaire écrit : les commits y sont faits avec son identité.
• Identité Git de l’agent : les commits de l’agent portent l’identité Git de la machine. Si elle n’en a aucune, Stib lui donne celle du propriétaire sur une machine personnelle ; sur une machine serveur, celle du dépôt du projet sur le serveur, ou à défaut celle du compte qui a lancé la carte.
• Pièces jointes et fichiers cités par @ vont dans le dossier de la carte sur la machine ; les fichiers que l’agent y dépose reviennent dans la conversation.

Limites actuelles

• Le compactage à la demande n’existe pas sur une machine : tapez /compact dans le fil.
• La bifurcation d’une conversation n’est pas proposée pour une carte sur une machine.
• Les fichiers ignorés par git (maquettes, plans, .env locaux…) ne suivent pas par origin : le dialogue de transfert les liste, et ceux que vous cochez sont copiés vers l’autre ordinateur, 50 Mo au total. Ils arrivent au prochain lancement de la carte.
• Une carte qui a travaillé (une conversation, ou un worktree ou une branche à elle) change de machine par le transfert : la conversation reprend par son historique, la session native reste sur la machine.
• Un autre compte du même fournisseur sur sa machine se choisit comme sur le serveur : la machine recopie la conversation pour le nouveau compte. Un autre fournisseur, ou le Compte de la machine, passe par le transfert, comme tout changement sur une machine dont le CLI Stib n’est pas à jour.
• Le worktree d’une carte reste sur la machine quand la carte est terminée ou supprimée.