Premiers pas avec GitScrum Studio

GitScrum Studio intègre l'ensemble de votre flux de gestion de projet dans votre éditeur de code. Gérez des tableaux Kanban, suivez le temps, exécutez des sprints, rédigez des pages wiki et collaborez avec votre équipe — le tout sans quitter VS Code, Cursor, Windsurf ou tout fork compatible.

Le problème résolu

Basculer entre votre éditeur de code et un outil de gestion de projet dans le navigateur brise la concentration. Chaque changement de contexte coûte des minutes de productivité et d'énergie mentale. Les développeurs perdent leur flux en vérifiant les détails d'une tâche, en enregistrant le temps ou en mettant à jour un statut dans une application séparée.

GitScrum Studio élimine cette friction. Vos tâches, tableaux, sprints, suivi du temps et communications d'équipe se trouvent à côté de votre code, dans la même fenêtre que celle où vous passez déjà votre journée.

Ce que vous voyez

Après l'installation de l'extension, une icône GitScrum apparaît dans la barre d'activité (la bande verticale d'icônes sur le côté gauche de votre éditeur). En cliquant dessus, vous accédez à la barre latérale GitScrum avec une arborescence organisée par espace de travail et par projet.

La structure de la barre latérale suit cette hiérarchie :

Nom de l'espace de travail
  └─ Nom du projet
       ├─ Plan
       │    ├─ Sprints
       │    ├─ User Stories
       │    └─ Team Standup
       ├─ Build
       │    └─ Board
       ├─ Knowledge
       │    ├─ Wiki
       │    ├─ Discussions
       │    └─ Documents
       └─ Time Tracking

Chaque élément ouvre un panneau webview dédié dans votre éditeur. Ces panneaux se comportent comme des onglets d'éditeur — vous pouvez les diviser, les réorganiser et les épingler à côté de votre code.

Installation

Depuis le Marketplace

1. Ouvrez VS Code, Cursor ou Windsurf
2. Accédez à la vue Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Recherchez GitScrum Studio
4. Cliquez sur Install

Vous pouvez également installer directement depuis le Visual Studio Marketplace.

Depuis la palette de commandes

1. Ouvrez la palette de commandes (Ctrl+Shift+P / Cmd+Shift+P)
2. Tapez ext install gitscrum-vscode.gitscrum-vscode
3. Appuyez sur Entrée

L'extension s'active automatiquement après l'installation. Aucun redémarrage de l'éditeur n'est nécessaire.

Authentification

GitScrum Studio nécessite une authentification pour se connecter à votre compte GitScrum.

Connexion

1. Cliquez sur l'icône GitScrum dans la barre d'activité
2. Cliquez sur Sign in dans la barre latérale
3. Une fenêtre de navigateur s'ouvre sur la page d'authentification GitScrum
4. Connectez-vous avec la méthode de votre choix : GitHub, Google, Facebook ou Email
5. Après une authentification réussie, le navigateur redirige automatiquement et l'extension se connecte

Votre jeton d'authentification est stocké de manière sécurisée via l'API SecretStorage intégrée à l'éditeur. Il persiste entre les sessions — vous n'avez pas besoin de vous connecter à chaque ouverture de l'éditeur.

Déconnexion

Ouvrez la palette de commandes et exécutez GitScrum: Sign Out. Vos identifiants stockés sont immédiatement supprimés.

État de l'authentification

La barre latérale affiche votre état de connexion. Lorsque vous êtes authentifié, l'arborescence de vos espaces de travail et projets apparaît. Lorsque vous êtes déconnecté, une invite de connexion s'affiche.

Sélection d'un espace de travail et d'un projet

Après la connexion :

1. La barre latérale charge vos espaces de travail disponibles
2. Développez un espace de travail pour voir ses projets
3. Cliquez sur un projet pour le définir comme actif
4. L'arborescence de la barre latérale se remplit avec les sections Plan, Build, Knowledge et Time Tracking du projet

Vous pouvez changer de projet à tout moment en cliquant sur un autre projet dans l'arborescence. Le projet actif détermine les données affichées dans tous les panneaux.

Commandes disponibles

Ouvrez la palette de commandes (Ctrl+Shift+P / Cmd+Shift+P) et tapez « GitScrum » pour voir toutes les commandes disponibles :

Le chronomètre dans la barre d'état

Un indicateur de suivi du temps persistant apparaît dans la barre d'état en bas de votre éditeur. Lorsqu'un chronomètre est en cours, il affiche le temps écoulé et le nom de la tâche en cours. Cliquez dessus pour accéder aux contrôles du chronomètre via un menu QuickPick :

• Start Timer : sélectionnez une tâche et commencez le suivi
• Stop Timer : arrêtez le chronomètre actif et enregistrez l'entrée
• Cancel Timer : annulez le chronomètre actif sans enregistrer

Le chronomètre persiste entre les sessions de l'éditeur. Si vous fermez et rouvrez votre éditeur, un chronomètre actif reprend là où il s'était arrêté.

Naviguer dans l'extension

Ouverture des panneaux

Cliquez sur n'importe quel élément de l'arborescence de la barre latérale pour ouvrir son panneau. Les panneaux s'ouvrent sous forme d'onglets d'éditeur :

• Board ouvre le tableau Kanban avec toutes les colonnes et tâches
• Sprints ouvre la liste des sprints avec recherche et filtres
• User Stories ouvre la liste des user stories
• Team Standup ouvre le flux de standup asynchrone
• Wiki ouvre l'éditeur de base de connaissances
• Discussions ouvre les canaux de discussion d'équipe
• Documents ouvre le navigateur de fichiers
• Time Tracking ouvre le tableau de bord de suivi du temps du projet

Comportement des panneaux

Les panneaux se comportent comme des onglets d'éditeur standard. Vous pouvez :

• Diviser les panneaux côte à côte avec des fichiers de code
• Épingler les panneaux pour les maintenir ouverts
• Fermer les panneaux avec Ctrl+W / Cmd+W
• Rouvrir les panneaux depuis la barre latérale ou la palette de commandes

Les données s'actualisent automatiquement à l'intervalle configuré. Cliquez sur le bouton d'actualisation dans l'en-tête de n'importe quel panneau pour une mise à jour immédiate.

Raccourcis clavier

L'extension ne remplace aucun raccourci par défaut de l'éditeur. Toutes les commandes sont accessibles via la palette de commandes. Vous pouvez attribuer des raccourcis clavier personnalisés à n'importe quelle commande GitScrum via l'éditeur de raccourcis clavier (Ctrl+K Ctrl+S / Cmd+K Cmd+S).

Compatibilité

GitScrum Studio fonctionne avec :

• VS Code 1.85.0 ou ultérieur
• Cursor (toutes les versions)
• Windsurf (toutes les versions)
• Tout éditeur basé sur l'API d'extension VS Code

L'extension nécessite une connexion internet active pour communiquer avec l'API GitScrum.

Astuces (une fois que vous serez à l'aise)

• Vue partagée : ouvrez le tableau Kanban dans un panneau divisé à côté de votre code. Faites glisser les tâches vers « Done » au fur et à mesure sans changer de fenêtre.

• Flux du chronomètre : démarrez le chronomètre depuis la barre d'état lorsque vous prenez une tâche. Un seul clic suffit pour construire des journaux de temps précis sans effort.

• Accès rapide : épinglez les panneaux fréquemment utilisés (Board, Time Tracking) pour qu'ils persistent entre les sessions de l'éditeur.

• La palette de commandes d'abord : apprendre les commandes GitScrum: vous permet d'accéder à n'importe quelle fonctionnalité en quelques secondes sans toucher la souris.

Permissions

L'extension respecte les permissions de votre compte GitScrum :

• Agency Owners et Managers : accès complet à toutes les fonctionnalités, paramètres et données d'équipe
• Developers : peuvent gérer les tâches, enregistrer le temps et contribuer aux outils de collaboration
• Clients : accès en lecture seule (si l'accès au projet est accordé)

Si une fonctionnalité apparaît désactivée ou si un panneau affiche des données limitées, vérifiez votre rôle dans le projet via l'application web GitScrum.

Comment signaler un problème ou demander une fonctionnalité

Si l'extension se comporte de manière inattendue ou si vous avez des suggestions d'amélioration, nous souhaitons vous entendre.

Dans la barre latérale de l'application web GitScrum, cliquez sur Support Tickets et ouvrez un ticket décrivant votre expérience. Incluez la version de l'extension (visible dans la vue Extensions) ainsi que le nom et la version de votre éditeur pour une résolution plus rapide.