Machines distantes (SSH)

Kanbell peut lancer un agent sur une autre machine, un VPS par exemple, par SSH. La session apparaît dans la barre latérale comme une session locale, avec le nom de la machine dessus. L'agent tourne dans tmux sur la machine distante : il continue de travailler quand tu fermes Kanbell.

Il n'y a aucun serveur Kanbell entre les deux. Tout passe par SSH, avec un tunnel inverse vers ton Mac.

Ce qu'il te faut

• Un accès SSH à la machine, avec un utilisateur qui peut s'y connecter.
• Une machine Linux.
• apt ou dnf sur la machine, pour installer tmux s'il manque.
• curl 7.76 ou plus récent sur la machine : le relais de Kanbell s'en sert pour remonter le statut, les questions et le tableau.
• Un projet dont le dossier est un dépôt git avec un remote, pour que Kanbell retrouve le même dossier sur la machine.

Ajouter une machine

1. Dans un projet, clique sur + et choisis Sur une machine….
2. Choisis un hôte de ton ~/.ssh/config, ou ajoute user@hôte.
3. Kanbell lance la préparation guidée ci-dessous. Tu la fais une seule fois par machine.

La préparation guidée

1. La connexion. Kanbell se connecte et te demande de vérifier l'empreinte de l'hôte.
2. Une clé SSH dédiée. Si la machine demande un mot de passe, Kanbell propose de poser dessus une clé dédiée. Il ne le fait qu'avec ton accord. Kanbell ne stocke ni ne tape jamais de mot de passe.
3. Le dossier du projet. Kanbell retrouve le dossier du projet sur la machine grâce à son remote git.
4. tmux et Claude Code. S'ils manquent, Kanbell installe tmux (avec apt ou dnf) et Claude Code (avec l'installeur officiel). Il te demande d'abord.
5. Claude se connecte sur la machine. Soit par la page de connexion ouverte sur ton Mac, soit avec une clé API.

Si le dossier n'est pas sur la machine, Kanbell ne clone pas le dépôt. Il affiche la commande git clone à lancer toi-même.

Fermer Kanbell, revenir plus tard

L'agent continue dans tmux. Quand tu rouvres Kanbell, il se reconnecte et se rattache à la session tout seul, sans clic.

Les questions arrivées pendant ton absence sont dans le panneau de la barre des menus, prêtes à recevoir ta réponse. Tu reçois une seule notification, pas une par question.

Ce qui marche comme pour un agent local

• L'état de la session : travaille, attend, terminée.
• Les questions et les demandes de permission, dans le panneau de la barre des menus.
• Le tableau des tâches et la commande kanbell pour l'agent.
• Une étiquette avec le nom de la machine sur la session.

Voir Répondre à tes agents et Tableau de tâches.

Quand la machine est injoignable

La session passe en gris et Kanbell se reconnecte tout seul. Une coupure est détectée en une vingtaine de secondes. L'agent n'est pas arrêté : il continue dans tmux sur la machine.

Limites

• Claude Code seulement. Codex et Gemini CLI ne tournent pas sur une machine distante.
• Machines Linux seulement.
• Une session distante s'affiche en terminal, pas dans la vue Focus.
• Kanbell ne clone pas le dépôt sur la machine.

Retour à Sessions et terminaux.