Sessions et workflow

Tactic Remote utilise des sessions tmux pour maintenir vos processus Claude Code actifs malgré les déconnexions. Cette page explique le fonctionnement des sessions et le workflow quotidien.

Fonctionnement des sessions

Chaque session correspond à :

• Un répertoire de travail (votre dossier de projet).
• Une session tmux sur votre Mac qui exécute Claude Code.
• Un flux de sortie terminal affiché sur votre iPhone.

Les sessions persistent même si :

• L'app iPhone est fermée ou en arrière-plan.
• Le réseau se déconnecte temporairement.
• Le Mac se met en veille et se réveille.

Quand vous vous reconnectez, l'app restaure la session et sa sortie terminal.

Créer une session

1. Tapez sur le sélecteur de session (en haut à gauche dans l'app).
2. Tapez sur Nouvelle session.
3. Naviguez dans le système de fichiers de votre Mac et sélectionnez un répertoire de projet.
4. Nommez la session (par ex. my-api, frontend-work).
5. Tapez Créer.

Vous pouvez avoir plusieurs sessions pour différents projets et basculer entre elles.

Démarrer Claude Code

Tapez le bouton Start pour lancer Claude Code dans la session courante.

L'app dispose d'une protection anti-doublon : si Claude Code tourne déjà dans la session, taper Start ne fait rien. Cela empêche les lancements accidentels en double.

Vérifiez avant de démarrer : Regardez l'indicateur d'état. Vert « Running » signifie que Claude est déjà actif -- pas besoin de taper Start.

Envoyer des prompts

Tapez dans le champ de saisie et envoyez. Votre prompt passe par le WebSocket jusqu'à votre Mac, qui le transmet au processus Claude Code. La sortie revient en streaming temps réel.

Actions rapides

L'app fournit des boutons raccourcis pour les saisies terminal courantes :

• Enter -- soumettre la saisie
• Escape -- annuler l'opération en cours
• Tab -- auto-complétion
• Touches fléchées -- naviguer
• Ctrl+C -- interrompre

Reconnexion

Quand l'app perd la connexion (changement de réseau, mise en arrière-plan, etc.) :

1. Elle tente automatiquement de se reconnecter avec un backoff exponentiel.
2. À la reconnexion, elle se réattache à votre session tmux existante.
3. La sortie terminal accumulée pendant la déconnexion est restaurée.

Vous n'avez rien à faire -- rouvrez simplement l'app.

Si la vue semble périmée : Ouvrez le sélecteur de session et re-sélectionnez votre session. Cela force un rafraîchissement.

Notifications

Pour les tâches de longue durée, pas besoin de garder l'app ouverte :

1. Claude Code supporte les hooks qui se déclenchent quand les tâches se terminent.
2. Le serveur relaie ces événements sous forme de notifications push vers votre iPhone.
3. Quand la notification arrive, ouvrez l'app pour examiner le résultat.

Gardez les permissions de notification iOS activées pour Tactic Remote.

Terminer une session

• Arrêter Claude : Tapez le bouton Stop pour terminer le processus Claude Code. La session reste disponible pour un redémarrage ultérieur.
• Supprimer la session : Depuis le sélecteur de session, glissez pour supprimer. Cela supprime la session tmux de votre Mac.