Questions fréquentes
Produit et installation
Faut-il l’application bureau et le serveur ?
Le serveur Stib est toujours nécessaire. L’application bureau est optionnelle : elle ajoute éditeur/terminal natifs, preview, fenêtres, téléchargements et updater. Le serveur fournit aussi le client web complet.
Où s’exécutent les agents ?
Sur la machine serveur, dans le dépôt du projet ou le worktree de la carte. Un client bureau relié à un serveur distant ne lance pas l’agent dans une autre copie locale.
Quels agents sont pris en charge ?
Stib gère plusieurs runtimes et expose les identifiants, modèles et capacités réellement découverts par le serveur. Questions natives, skills, plan, compact, sous-agents ou objectifs varient selon fournisseur/version.
Quels paquets bureau existent ?
macOS Apple Silicon : DMG/PKG. Windows x64/x86/ARM64 : EXE/MSI. Linux x64/ARM64 : DEB/RPM. Aucune AppImage n’est publiée actuellement.
Quel port utilise le serveur ?
Une version publiée préfère 50505, puis essaie 50506 à 50514, puis un port attribué par le système. Docker écoute toujours sur le port conteneur 50505. Consultez port.txt, la barre système, les logs ou l’écran de connexion.
Où sont les données ?
En natif, dans le dossier de données applicatives stib-server du système ; sous Docker, dans le volume persistant /data. Voir Binaire serveur. Le code reste dans les dépôts configurés.
Comment fonctionnent les mises à jour ?
Client bureau et serveur natif ont des manifestes signés séparés. Docker se met à jour en tirant puis recréant l’image. Sauvegardez le serveur avant ; mettre à jour le bureau ne migre ni ne supprime ses données.
Cartes, agents et Git
Créer une carte lance-t-il immédiatement un agent ?
Cela dépend de la colonne cible, de l’activation et des réglages. Une colonne passive n’exécute rien. Une colonne active peut démarrer immédiatement ; une carte différée attend son activation.
Différence entre mode Auto et Boucle ?
Auto déplace la carte dans les colonnes de pipeline. Boucle la relance selon un calendrier sans changer de colonne.
Les sessions survivent-elles au rafraîchissement ?
La session appartient au serveur, pas à l’onglet. Rouvrir la carte retrouve son état courant/persisté. Après redémarrage serveur, Stib réconcilie le travail ; il ne ressuscite pas un processus externe disparu.
Que reste-t-il après annulation ou erreur ?
Messages, historique et fichiers déjà écrits restent. Inspectez Diff et l’espace Git avant de relancer ou nettoyer.
Les worktrees sont-ils automatiques ?
C’est une option de carte qui peut être choisie par défaut, mais elle exige Git et une colonne compatible. Un worktree isole fichiers/index ; il ne commit, push ni merge automatiquement.
Stib fonctionne-t-il sans Git ?
Des usages limités acceptent un dossier normal, mais worktrees, branches, diffs/historique et fonctions de revue exigent Git. Git est fortement recommandé.
Comptes et exploitation
Plusieurs utilisateurs peuvent-ils partager un serveur ?
Oui. Les rôles serveur, organisation, projet et colonne déterminent l’accès, sous réserve de siège de licence et de politique d’authentification.
Quels fournisseurs OIDC fonctionnent ?
Stib utilise la découverte OIDC standard et le code d’autorisation avec PKCE. Un fournisseur convient s’il expose découverte, endpoints, claims ID-token et enregistrement de callback compatibles. Testez sa configuration exacte avant déploiement.
Une clé API Stib est-elle une clé fournisseur agent ?
Non. La clé Stib autorise des endpoints d’automatisation projet. La clé fournisseur autorise le runtime agent à appeler un modèle. Stockez-les et limitez-les séparément.
La corbeille est-elle une sauvegarde ?
Non. C’est une rétention de cartes supprimées. Utilisez Paramètres → Serveur → Sauvegarde, stockez les sauvegardes indépendamment et testez la restauration.
Peut-on utiliser un reverse proxy ?
Oui. Transmettez HTTP et les upgrades WebSocket, utilisez HTTPS et définissez STIB_SERVER_ORIGIN avec l’origine publique pour OIDC. L’application bureau utilise cette origine sans /api.