Questions fréquentes

Retrouvez les réponses aux questions les plus courantes sur Stib. Si votre question n'est pas traitée ici, consultez la page Dépannage ou contactez-nous.

Général

Qu'est-ce que Stib ?

Stib est un orchestrateur d'agents Claude Code avec un tableau Kanban visuel. Il vous permet de lancer, surveiller et interagir avec des agents Claude Code via une interface intuitive — en gérant vos tâches de développement assistées par IA comme n'importe quel tableau de projet.

Stib fonctionne en tant que serveur auto-hébergé et est disponible sous forme d'image Docker, de binaire pré-compilé ou d'application de bureau. Une application mobile compagnon vous permet de gérer vos agents en déplacement.

→ En savoir plus sur Stib

Qu'est-ce que Claude Code ?

Claude Code est l'outil de programmation agentique d'Anthropic. Il s'exécute dans un terminal et peut lire, écrire et exécuter du code de manière autonome. Stib enveloppe Claude Code avec une interface visuelle, des sessions persistantes et l'automatisation du pipeline.

Quelles plateformes sont supportées ?

Stib fonctionne sur macOS, Linux et Windows. L'application de bureau inclut l'intégration au system tray pour les trois plateformes. L'application mobile fonctionne sur iOS et Android.

→ Vérifier les prérequis

Stib est-il open source ?

Stib est un produit commercial avec une licence propriétaire. Consultez le site web pour les termes complets de la licence.

Quelles sont les exigences système ?

Stib nécessite :

• Claude Code CLI installé et authentifié
• Git (optionnel, pour les fonctionnalités de worktree)
• CPU et RAM minimaux — Stib est léger ; les agents Claude Code font le gros du travail via l'API

→ Prérequis complets

Installation

Quelle méthode d'installation choisir ?

Méthode	Idéale pour
Docker	Mise en place rapide, environnement isolé, déploiements serveur
Docker Compose	Configurations de production personnalisées
Binaire	Installation directe sans conteneurs
Bureau	Utilisation personnelle avec intégration au system tray

→ Guides d'installation

Quel est le port par défaut ?

Stib écoute sur le port 50505 par défaut. Le port est fixe et non configurable.

→ Options de configuration

Où sont stockées mes données ?

Toutes les données sont stockées dans une base de données SQLite dans le répertoire de données de Stib. L'emplacement par défaut dépend de votre méthode d'installation :

• Docker : Dans le conteneur à /data (montez un volume pour persister)
• Binaire/Bureau : Dans le répertoire de données spécifique à l'OS (ex. ~/.local/share/stib sur Linux, ~/Library/Application Support/stib sur macOS)

TIP

Avec Docker, montez toujours un volume (-v stib-data:/app/data) pour préserver vos données entre les redémarrages du conteneur.

→ Configuration et chemins de données

Comment mettre à jour Stib ?

Le processus de mise à jour dépend de votre méthode d'installation :

• Docker : Tirez la dernière image et redémarrez le conteneur
• Binaire : Téléchargez la nouvelle version et remplacez le binaire
• Bureau : Téléchargez la dernière version depuis la page de téléchargement et installez-la par-dessus la version existante

→ Instructions de mise à jour

Puis-je utiliser un reverse proxy ?

Oui. Stib fonctionne derrière des reverse proxies comme Nginx, Caddy ou Traefik. Assurez-vous de :

• Transférer les connexions WebSocket (utilisées pour la synchronisation temps réel)
• Définir la variable d'environnement STIB_SERVER_ORIGIN sur votre URL publique
• Transmettre les headers Upgrade et Connection pour le support WebSocket

WARNING

Le transfert WebSocket est obligatoire. Sans lui, les mises à jour en temps réel (sortie des agents, déplacements de cartes) ne fonctionneront pas.

Agents & Pipeline

Que se passe-t-il si un agent échoue ?

Si un agent Claude Code rencontre une erreur ou plante, la carte reste dans sa colonne actuelle et l'état d'erreur est affiché sur la carte. Vous pouvez relancer l'agent depuis le menu d'actions de la carte. L'historique de session est préservé pour que l'agent puisse reprendre avec le contexte complet.

→ Guide d'interaction avec les agents

Qu'est-ce que la saturation de contexte ?

La saturation de contexte survient lorsque la fenêtre de contexte d'un agent Claude Code est pleine. Lorsque cela arrive, Stib effectue automatiquement un relais de contexte : il lance un nouvel agent et transfère le contexte de conversation pour que le travail continue sans interruption. Aucune intervention manuelle n'est nécessaire.

→ En savoir plus sur le relais de contexte

Comment fonctionne le mode auto ?

Le mode auto permet de définir une progression automatique du pipeline. Quand un agent termine son travail dans une colonne, Stib déplace automatiquement la carte vers la colonne suivante et lance un nouvel agent. Vous pouvez configurer quelles colonnes sont enchaînées et définir des points d'arrêt où le pipeline se met en pause pour une revue humaine.

→ Automatisation du pipeline

Puis-je annuler un agent en cours d'exécution ?

Oui. Vous pouvez annuler un agent en cours d'exécution à tout moment depuis le panneau overlay de la carte ou depuis son menu d'actions. Le processus de l'agent est terminé et la carte reste dans sa colonne actuelle. Vous pouvez relancer l'agent ensuite.

→ Contrôles des agents

Les agents survivent-ils au rafraîchissement de la page ?

Oui. Les sessions d'agents sont entièrement persistantes. Si vous fermez le navigateur, rafraîchissez la page ou vous déconnectez, l'agent continue de tourner sur le serveur. Lorsque vous vous reconnectez, vous retrouvez l'historique complet de la conversation et pouvez reprendre l'interaction immédiatement.

→ Persistance des agents

Git & Worktrees

Qu'est-ce qu'un worktree ?

Un worktree Git est un répertoire de travail séparé lié au même dépôt. Stib crée un worktree dédié pour chaque carte, donnant à chaque agent sa propre copie isolée du code. Cela empêche les agents d'interférer avec les modifications des autres.

→ Détails de l'intégration Git

Comment les branches sont-elles nommées ?

Stib crée des branches suivant le pattern stib/<card-id>-<card-title-slug>. Chaque carte obtient une branche unique dans son propre worktree, gardant les modifications organisées et faciles à identifier.

→ Conventions de branches

Quand les worktrees sont-ils nettoyés ?

Les worktrees sont automatiquement nettoyés lorsqu'une carte atteint la colonne finale (typiquement « Done »). Vous pouvez également nettoyer manuellement les worktrees depuis le menu d'actions de la carte. La branche associée est préservée sauf si vous la supprimez explicitement.

→ Nettoyage des worktrees

Puis-je utiliser Stib sans Git ?

Oui. L'intégration Git est entièrement optionnelle. Si votre répertoire de projet n'est pas un dépôt Git, Stib passe simplement la création de worktree et la gestion des branches. Toutes les autres fonctionnalités — agents, pipeline, tableau Kanban — fonctionnent normalement.

Mobile

Quels appareils sont supportés ?

L'application mobile Stib fonctionne sur iOS et Android. Elle nécessite une connexion réseau vers votre serveur Stib.

→ Aperçu mobile

Comment connecter l'application mobile ?

Vous pouvez vous connecter de deux façons :

1. QR Code — Ouvrez les Paramètres dans l'interface web de Stib et scannez le QR code avec l'application mobile
2. Saisie manuelle — Entrez l'URL de votre serveur et vos identifiants d'authentification directement dans l'application

→ Guide de connexion mobile

Que puis-je faire sur mobile ?

L'application mobile vous permet de :

• Parcourir les projets et les boards
• Consulter le tableau Kanban et les détails des cartes
• Créer des cartes et les déplacer entre les colonnes
• Discuter avec les agents en cours d'exécution
• Suivre l'exécution des agents en temps réel

→ Guide d'utilisation mobile

L'application mobile fonctionne-t-elle hors ligne ?

Non. L'application mobile nécessite une connexion réseau vers votre serveur Stib. Toutes les données sont stockées sur le serveur et l'application reçoit les mises à jour en temps réel via WebSocket.

Compte & Authentification

Comment configurer le SSO ?

Stib supporte le Single Sign-On OIDC avec tout fournisseur d'identité compatible. La configuration se fait depuis la page Paramètres de l'interface web. Stib inclut des presets pour les fournisseurs courants comme Google, Microsoft Entra ID et Keycloak.

→ Guide de configuration de l'authentification

Plusieurs utilisateurs peuvent-ils partager une instance Stib ?

Oui. Lorsque l'authentification est activée, plusieurs utilisateurs peuvent se connecter et collaborer. Les projets peuvent être partagés avec des utilisateurs spécifiques ou rattachés à des organisations. Chaque utilisateur ne voit que les projets auxquels il a accès.

→ Projets & Organisations

Quels fournisseurs OIDC sont supportés ?

Stib fonctionne avec tout fournisseur compatible OIDC, notamment :

• Google (Google Workspace)
• Microsoft Entra ID (Azure AD)
• Keycloak
• Auth0
• Okta
• Tout fournisseur implémentant le standard OpenID Connect

→ Configuration OIDC

Comment gérer les sauvegardes ?

Stib inclut une fonctionnalité de sauvegarde intégrée accessible depuis les Paramètres. Vous pouvez créer des sauvegardes manuelles ou configurer des sauvegardes automatiques périodiques. Les sauvegardes incluent la base de données SQLite et les données de configuration.

→ Gestion des sauvegardes

Étapes suivantes

Vous ne trouvez pas ce que vous cherchez ? Consultez le guide Dépannage & Logs pour diagnostiquer les problèmes courants, ou parcourez la documentation complète pour une couverture approfondie de chaque fonctionnalité.