Primeros Pasos con GitScrum Studio

GitScrum Studio lleva todo tu flujo de gestión de proyectos a tu editor de código. Gestiona tableros Kanban, registra tiempo, ejecuta sprints, escribe páginas wiki y colabora con tu equipo — todo sin salir de VS Code, Cursor, Windsurf o cualquier fork compatible.

El problema que resuelve

Alternar entre tu editor de código y una herramienta de gestión de proyectos en el navegador rompe la concentración. Cada cambio de contexto cuesta minutos de productividad y energía mental. Los desarrolladores pierden el estado de flujo al consultar detalles de tareas, registrar tiempo o actualizar estados en una aplicación separada.

GitScrum Studio elimina esa fricción. Tus tareas, tableros, sprints, seguimiento de tiempo y comunicación de equipo conviven junto a tu código en la misma ventana donde ya pasas tu día.

Lo que estás viendo

Después de instalar la extensión, un ícono de GitScrum aparece en la Barra de Actividad (la franja vertical de íconos en el lado izquierdo de tu editor). Al hacer clic se muestra la barra lateral de GitScrum con una vista de árbol organizada por workspace y proyecto.

La estructura de la barra lateral sigue esta jerarquía:

Nombre del Workspace
  └─ Nombre del Proyecto
       ├─ Plan
       │    ├─ Sprints
       │    ├─ User Stories
       │    └─ Team Standup
       ├─ Build
       │    └─ Board
       ├─ Knowledge
       │    ├─ Wiki
       │    ├─ Discussions
       │    └─ Documents
       └─ Time Tracking

Cada elemento abre un panel webview dedicado dentro de tu editor. Estos paneles se comportan como pestañas del editor — puedes dividirlos, reorganizarlos y fijarlos junto a tu código.

Instalación

Desde el Marketplace

1. Abre VS Code, Cursor o Windsurf
2. Ve a la vista de Extensiones (Ctrl+Shift+X / Cmd+Shift+X)
3. Busca GitScrum Studio
4. Haz clic en Install

Alternativamente, instala directamente desde el Visual Studio Marketplace.

Desde la Paleta de Comandos

1. Abre la Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P)
2. Escribe ext install gitscrum-vscode.gitscrum-vscode
3. Presiona Enter

La extensión se activa automáticamente tras la instalación. No requiere reiniciar el editor.

Autenticación

GitScrum Studio requiere autenticación para conectarse a tu cuenta de GitScrum.

Iniciar sesión

1. Haz clic en el ícono de GitScrum en la Barra de Actividad
2. Haz clic en Sign in en la barra lateral
3. Se abre una ventana del navegador con la página de autenticación de GitScrum
4. Inicia sesión con tu método preferido: GitHub, Google, Facebook o Email
5. Tras la autenticación exitosa, el navegador redirige de vuelta y la extensión se conecta automáticamente

Tu token de autenticación se almacena de forma segura usando la API SecretStorage integrada del editor. Persiste entre sesiones — no necesitas iniciar sesión cada vez que abres el editor.

Cerrar sesión

Abre la Paleta de Comandos y ejecuta GitScrum: Sign Out. Esto borra tus credenciales almacenadas de inmediato.

Estado de autenticación

La barra lateral muestra tu estado de conexión. Cuando estás autenticado, aparece el árbol de tu workspace y proyectos. Cuando no has iniciado sesión, se muestra un mensaje para iniciar sesión.

Seleccionar un Workspace y Proyecto

Después de iniciar sesión:

1. La barra lateral carga tus workspaces disponibles
2. Expande un workspace para ver sus proyectos
3. Haz clic en un proyecto para establecerlo como activo
4. El árbol de la barra lateral se completa con las secciones Plan, Build, Knowledge y Time Tracking de ese proyecto

Puedes cambiar de proyecto en cualquier momento haciendo clic en un proyecto diferente en el árbol. El proyecto activo determina qué datos aparecen en todos los paneles.

Comandos disponibles

Abre la Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P) y escribe "GitScrum" para ver todos los comandos disponibles:

El temporizador en la barra de estado

Un indicador persistente de seguimiento de tiempo aparece en la barra de estado en la parte inferior de tu editor. Cuando un temporizador está activo, muestra el tiempo transcurrido y el nombre de la tarea actual. Haz clic para acceder a los controles del temporizador a través de un menú QuickPick:

• Start Timer: Selecciona una tarea y comienza el seguimiento
• Stop Timer: Detiene el temporizador activo y registra la entrada
• Cancel Timer: Descarta el temporizador activo sin registrar

El temporizador persiste entre sesiones del editor. Si cierras y vuelves a abrir tu editor, un temporizador activo continúa desde donde se quedó.

Navegando por la extensión

Abrir paneles

Haz clic en cualquier elemento del árbol de la barra lateral para abrir su panel. Los paneles se abren como pestañas del editor:

• Board abre el tablero Kanban con todas las columnas y tareas
• Sprints abre la lista de sprints con búsqueda y filtros
• User Stories abre la lista de historias de usuario
• Team Standup abre el flujo de standup asíncrono
• Wiki abre el editor de la base de conocimiento
• Discussions abre los canales de chat del equipo
• Documents abre el explorador de archivos
• Time Tracking abre el panel de seguimiento de tiempo del proyecto

Comportamiento de los paneles

Los paneles se comportan como pestañas estándar del editor. Puedes:

• Dividir paneles lado a lado con archivos de código
• Fijar paneles para mantenerlos abiertos
• Cerrar paneles con Ctrl+W / Cmd+W
• Reabrir paneles desde la barra lateral o la Paleta de Comandos

Los datos se actualizan automáticamente en el intervalo configurado. Haz clic en el botón de actualizar en el encabezado de cualquier panel para una actualización inmediata.

Atajos de teclado

La extensión no sobreescribe ningún atajo predeterminado del editor. Todos los comandos son accesibles a través de la Paleta de Comandos. Puedes asignar atajos de teclado personalizados a cualquier comando de GitScrum a través del editor de Atajos de Teclado (Ctrl+K Ctrl+S / Cmd+K Cmd+S).

Compatibilidad

GitScrum Studio funciona con:

• VS Code 1.85.0 o posterior
• Cursor (todas las versiones)
• Windsurf (todas las versiones)
• Cualquier editor basado en la API de extensiones de VS Code

La extensión requiere una conexión a internet activa para comunicarse con la API de GitScrum.

Consejos avanzados (una vez que te sientas cómodo)

• Vista dividida: Abre el tablero Kanban en un panel dividido junto a tu código. Arrastra tareas a "Done" a medida que las completas sin cambiar de ventana.

• Flujo del temporizador: Inicia el temporizador desde la barra de estado cuando tomes una tarea. Solo necesitas un clic y genera registros de tiempo precisos sin esfuerzo.

• Acceso rápido: Fija los paneles que usas con frecuencia (Board, Time Tracking) para que persistan entre sesiones del editor.

• Paleta de Comandos primero: Aprender los comandos GitScrum: te permite acceder a cualquier función en segundos sin tocar el ratón.

Permisos

La extensión respeta los permisos de tu cuenta de GitScrum:

• Agency Owners y Managers: Acceso completo a todas las funciones, configuraciones y datos del equipo
• Developers: Pueden gestionar tareas, registrar tiempo y contribuir a las herramientas de colaboración
• Clients: Acceso de solo lectura (si se les otorga acceso al proyecto)

Si una función aparece deshabilitada o un panel muestra datos limitados, verifica tu rol en el proyecto dentro de la aplicación web de GitScrum.

Cómo reportar un problema o solicitar una función

Si la extensión se comporta de forma inesperada o tienes sugerencias de mejora, queremos saberlo.

En la barra lateral de la aplicación web de GitScrum, haz clic en Support Tickets y abre un ticket describiendo tu experiencia. Incluye la versión de la extensión (visible en la vista de Extensiones) y el nombre y versión de tu editor para una resolución más rápida.