Aide et FAQ

Tout ce qu'il faut pour démarrer avec TermBuddy, ainsi que les réponses aux questions les plus fréquentes.

Démarrage rapide

1. Ajoutez un serveur

Ouvrez TermBuddy, touchez « Ajouter un serveur » et saisissez l'adresse, le port SSH et le nom d'utilisateur, avec un mot de passe ou une clé SSH. C'est tout : TermBuddy se connecte en SSH et installe automatiquement son petit assistant sur le serveur.

2. Créez un Buddy

Un Buddy est une session persistante sur votre serveur, présentée comme une conversation. Créez un Buddy Terminal pour lancer des commandes comme on envoie des messages, ou un Buddy IA (Claude Code, Codex ou Gemini) qui travaille dans le répertoire de projet de votre choix.

3. Discutez

Envoyez des commandes ou des instructions ; la sortie revient en réponses. Fermez l'app quand vous voulez : les tâches longues continuent sur le serveur et vous recevez une notification à la fin.

Questions fréquentes

Qu'est-ce que TermBuddy exactement ?

TermBuddy transforme vos serveurs distants en conversations sur iPhone et Mac. Les sessions de terminal et les agents IA (Claude Code, Codex, Gemini CLI) deviennent des « buddies » auxquels vous écrivez. Les sessions persistent sur le serveur, donc le travail continue même quand votre téléphone est dans votre poche.

Est-ce sécurisé ? Quels ports dois-je ouvrir ?

Uniquement SSH (en général le port 22), celui que vous utilisez déjà. L'assistant installé par TermBuddy sur votre serveur n'écoute que sur 127.0.0.1 et n'est jamais exposé à Internet ; tout le trafic passe par votre connexion SSH. Les identifiants sont stockés dans le Trousseau système de votre appareil, et rien ne transite par un serveur tiers.

De quoi ai-je besoin sur le serveur ?

D'un serveur Linux ou macOS accessible en SSH. Aucune configuration manuelle : TermBuddy envoie et configure son assistant pour vous. Pour les Buddies IA, il faut aussi que la CLI IA (par exemple Claude Code) soit installée et connectée sur le serveur ; la page du serveur propose un installateur guidé pour cela.

Quels assistants IA sont pris en charge ?

Claude Code, OpenAI Codex CLI et Google Gemini CLI. L'IA s'exécute sur votre serveur, dans le répertoire de travail que vous choisissez, avec sa propre connexion et sa propre facturation (par exemple votre compte Anthropic). TermBuddy est la télécommande : plans, tâches, questions et résultats arrivent sous forme de messages.

Les commandes s'arrêtent-elles si je ferme l'app ?

Non. Les sessions vivent sur le serveur. Fermez l'app, perdez le réseau, changez d'appareil : à votre retour, tout l'historique est là. Des notifications vous préviennent quand une tâche longue se termine ou échoue.

Qu'est-ce que la bibliothèque de mémoire (Experience) ?

Une base de connaissances personnelle (préférences, notes de projet, leçons apprises) synchronisée automatiquement depuis votre Mac vers tous vos serveurs, utilisable par chaque Buddy IA. Importez votre mémoire Claude existante en un geste, et laissez la fonction « Catégoriser » demander à une IA de tout ranger par thème.

Que sont les Skills ?

Des paquets d'instructions réutilisables (revue de code, débogage systématique, TDD, analyse de données, rédaction scientifique, etc.) qui apprennent aux Buddies IA à bien exécuter une tâche. Activez-les dans l'onglet Skills de l'app Mac : ils se déploient sur tous vos serveurs et l'IA choisit le bon quand votre demande correspond.

Mon buddy reste bloqué sur « Traitement… », que faire ?

Ouvrez l'onglet Serveurs et vérifiez l'état du serveur. Redémarrer l'assistant TermBuddy depuis cet écran règle la plupart des cas ; si un point rouge signale une mise à jour, mettez l'assistant à jour. Vérifiez aussi sur la page du serveur que la CLI IA est installée et connectée.

Je n'arrive pas à me connecter à mon serveur.

Vérifiez d'abord qu'un SSH classique fonctionne depuis un autre terminal avec le même hôte, port, utilisateur et identifiants. Si SSH passe mais pas TermBuddy, consultez l'état du serveur dans l'onglet Serveurs, puis le journal côté serveur : ~/.termbuddy/termbuddy.log.

Comment se passent les mises à jour ?

Les apps se mettent à jour via l'App Store. L'assistant serveur se met à jour depuis l'app : un point rouge sur l'onglet Serveurs signale une nouvelle version, et une seule touche la déploie en SSH.

Quelles données collectez-vous ?

Votre appareil parle directement à votre serveur, sans relais. Nous ne voyons jamais vos identifiants, vos commandes, vos sorties ni vos fichiers. Voir la politique de confidentialité pour le détail.

Où obtenir de l'aide ?

Écrivez à atlai@atlai.co.uk ou utilisez « Envoyer un commentaire » dans l'app. Les rapports de bug accompagnés du journal serveur (~/.termbuddy/termbuddy.log) nous aident beaucoup.