Référence CLI

Fonctionnalités Principales

Système de fichiers distant : Accédez et éditez des fichiers locaux depuis l’application mobile Spck Editor
Intégration Git : Opérations git complètes (commit, push, pull, gestion des branches) — nécessite Git 2.20.0+
Accès terminal : Sessions de terminal interactives avec xterm.js
Proxy navigateur : Prévisualisez votre serveur local dans une vue navigateur plein écran dans Spck Editor
Recherche rapide : Recherche de fichiers optimisée avec détection automatique de ripgrep (100x plus rapide quand installé)
Agents IA de code locaux (ACP) : Pilotez Claude Code, Codex ou Gemini CLI depuis le Chat IA de Spck Editor via l’Agent Client Protocol. L’agent s’exécute sur votre machine avec votre propre abonnement. Voir Agents IA de code sur mobile (ACP).
Sécurisé : Requêtes signées cryptographiquement avec authentification Firebase optionnelle

Serveur Relay

La CLI se connecte à Spck Editor via un serveur relay qui transmet les messages entre les deux. Au premier lancement, la CLI sélectionne automatiquement le serveur relay avec la latence la plus faible et enregistre la préférence dans ~/.spck-editor/.credentials.json.

IMPORTANT : La CLI et le client Spck Editor doivent utiliser le même serveur relay pour se connecter. Si le client ne trouve pas la CLI, vérifiez que les deux côtés ont sélectionné le même serveur relay.

Serveurs Relay Disponibles

Région	URL
Europe	`cli-eu-1.spck.io`
Amérique du Nord	`cli-na-1.spck.io`
Asie du Sud	`cli-sas-1.spck.io`
Asie de l’Est	`cli-ea-1.spck.io`

Remplacer le Serveur Relay

# Utiliser un serveur relay spécifique
spck --server cli-eu-1.spck.io

# Forme courte
spck -s cli-na-1.spck.io

Le remplacement est sauvegardé et réutilisé lors des exécutions suivantes. Pour relancer la sélection automatique, effacez vos identifiants et redémarrez :

spck --logout
spck

Choisir un Serveur Relay dans Spck Editor

Lors de la connexion depuis l’application mobile via Link Remote Server, sélectionnez le même serveur relay dans le menu déroulant Relay Server que celui utilisé par la CLI. Le nom du serveur relay est affiché dans la sortie de la CLI après la connexion.

Flux de Travail Quotidien

Démarrer Votre Session

cd /path/to/project
spck
# Se connecter depuis l'application mobile (connexion automatique au serveur enregistré)
# Commencer à coder

Éditer des Fichiers

Parcourir les fichiers dans l’application mobile
Appuyer pour ouvrir et éditer
Les fichiers se sauvegardent automatiquement sur votre ordinateur

Exécuter des Commandes Git

Option 1 - GUI de l’application mobile :

Ouvrir le panneau Git
Voir les changements, préparer les fichiers
Commiter et pousser

Option 2 - Terminal :

git status
git add .
git commit -m "Update feature"
git push

Sessions Terminal

Appuyez sur l’icône terminal dans l’application mobile pour un accès shell complet avec vos permissions utilisateur.

Terminer Votre Session

# Garder la CLI active pour des reconnexions rapides (recommandé)
# Ou arrêter avec Ctrl+C

Dépannage

Répertoire Racine Non Trouvé

# Reconfigurer avec le bon chemin
spck --setup

# Ou spécifier directement
spck --root /correct/path/to/project

Configuration Corrompue

# Effacer les paramètres et recommencer
spck --logout
spck --setup

Problèmes de Connexion

Vérifier la connexion internet
Vérifier que la CLI et Spck Editor utilisent le même serveur relay (affiché dans la sortie de la CLI après la connexion)
Essayer de se déconnecter et se reconnecter :
```
spck --logout
spck
```
Vérifier les paramètres du pare-feu — s’assurer que les connexions WebSocket (port 443) sont autorisées

Le Code QR Ne Se Scanne Pas

Vérifier que l’application Spck Editor est installée avant de scanner
Utiliser la saisie manuelle : Projects → New Project → Link Remote Server
Utiliser l’application Appareil photo native, pas des scanners tiers

Les Opérations Git Ne Fonctionnent Pas

Vérifier que Git est installé :
```
git --version  # Nécessite 2.20.0+
```

Installer si nécessaire :

# macOS
brew install git

# Ubuntu/Debian
sudo apt-get install git

# Windows : Télécharger depuis git-scm.com

Performance de Recherche Lente

Installez ripgrep pour une recherche 100x plus rapide :

# macOS
brew install ripgrep

# Ubuntu/Debian
sudo apt-get install ripgrep

# Windows (Chocolatey)
choco install ripgrep

# La CLI détecte et utilise automatiquement ripgrep

Permission Refusée

# Voir les permissions
ls -la /path/to/file

# Corriger si nécessaire
chmod 644 /path/to/file

# Ne pas utiliser sudo - la CLI doit s'exécuter en tant qu'utilisateur propriétaire des fichiers

Limites de Connexion

Le nombre maximum de connexions CLI simultanées et les limites d’utilisation quotidienne dépendent de votre type de compte :

Plan	Connexions CLI	Limite Quotidienne
Free	1	30 minutes
Supporter	2	Illimité
Gold	5	Illimité

L’utilisation du niveau gratuit se réinitialise quotidiennement à 00h00 UTC.

Quand la limite de connexions est atteinte :

⚠️  Maximum of X CLI connections reached.
Close other CLI instances and try again.

Quand la limite quotidienne gratuite est atteinte :

⚠️  Daily free tier limit of 30 minutes has been reached.
Upgrade to continue using CLI.

Vérifier les connexions actives :

spck --account

💡 Note : Un seul appareil mobile peut se connecter à une instance CLI à la fois. Chaque instance CLI utilise un slot de connexion.

Support

Site web : https://spck.io
Support : Contact via l’application mobile Spck Editor