tmux

Tmux (Terminal Multiplexer) permet aux sessions de terminal de s'exécuter indépendamment de la fenêtre ou de la connexion SSH qui les a démarrées. Pour les utilisateurs de Spck CLI, cela signifie que vous pouvez maintenir des sessions actives lors des reconnexions, partager une session d'agent en cours entre le bureau et le mobile, et exécuter la CLI de manière persistante sur un serveur distant même après la chute de votre connexion SSH.

Installation

brew install tmux

sudo apt-get install tmux

sudo dnf install tmux

sudo pacman -S tmux

wsl --install

sudo apt-get install tmux

Cas d'usage 1 : Partager des sessions d'agent entre bureau et mobile

Le workflow tmux le plus puissant avec Spck CLI consiste à démarrer un agent de codage IA sur votre bureau et à le reprendre facilement depuis votre mobile — ou l'inverse. Les deux voient exactement le même état du terminal, y compris l'historique de défilement complet.

💡 Astuce : Si vous utilisez un agent compatible ACP (Claude Code, Codex, Gemini CLI), vous pouvez le piloter depuis le Chat IA de Spck Editor sans même partager de terminal. Voir Agents IA de code sur mobile (ACP) — tmux reste utile pour les agents basés sur le shell ou lorsque vous souhaitez voir la sortie brute de l'agent en direct entre appareils.

Démarrer une session sur le bureau

Créez une session tmux nommée :

tmux new -s code

Lancez votre agent IA dans la session :

claude

L'agent s'exécute dans tmux. Détachez-vous à tout moment en appuyant sur Ctrl+B puis D — la session et tout ce qui s'y exécute continue en arrière-plan.

Se connecter depuis le mobile

1. Ouvrez Spck Editor et connectez-vous à votre serveur CLI
2. Ouvrez un terminal depuis le panneau terminal de Spck Editor
3. Rattachez-vous à la session tmux en cours :

tmux attach -t code

Vous voyez exactement le même terminal que sur votre bureau — y compris l'agent en cours d'exécution, sa sortie et l'historique de défilement complet. Plusieurs clients peuvent se connecter simultanément et voir la sortie en direct.

Revenir au bureau

Reconnectez-vous depuis n'importe quel terminal à tout moment :

tmux attach -t code

Cas d'usage 2 : CLI persistante sur un serveur distant

Si vous exécutez Spck CLI sur un serveur distant via SSH, la CLI s'arrête dès que la session SSH se termine — que vous fermiez votre ordinateur portable, perdiez le Wi-Fi ou que la connexion expire. Tmux maintient le processus actif sur le serveur quel que soit l'état de votre connexion.

Configuration sur le serveur distant

Connectez-vous en SSH à votre serveur et démarrez une session tmux nommée avant de lancer la CLI :

ssh [email protected]
tmux new -s spck
spck

La CLI s'exécute maintenant dans tmux sur le serveur. Fermez la connexion SSH — ou perdez-la complètement — et la CLI continue de fonctionner.

Se reconnecter après une déconnexion

ssh [email protected]
tmux attach -t spck

La CLI reprend exactement là où elle s'était arrêtée. Les clients mobiles peuvent se reconnecter normalement via le serveur relais.

Lister les sessions en cours

tmux ls

Alternative : Service Linux

Pour une configuration entièrement automatisée qui démarre la CLI au démarrage sans gestion manuelle de tmux, exécutez Spck CLI en tant que service systemd.

Créer le fichier de service

sudo nano /etc/systemd/system/spck-cli.service

[Unit]
Description=Spck CLI Server
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/path/to/your/project
ExecStart=/usr/bin/npx spck
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Remplacez your-username et /path/to/your/project par vos valeurs réelles. Si vous avez installé spck globalement (npm install -g spck), remplacez ExecStart par la sortie de which spck.

Activer et démarrer

sudo systemctl daemon-reload
sudo systemctl enable spck-cli
sudo systemctl start spck-cli

Vérifier le statut et les journaux

# Voir le statut
sudo systemctl status spck-cli

# Suivre les journaux en direct
journalctl -u spck-cli -f

Le service démarre automatiquement à chaque redémarrage et redémarre lui-même si le processus plante.

Commandes essentielles de Tmux