Primeiros Passos com o GitScrum Studio

O GitScrum Studio traz todo o seu fluxo de trabalho de gerenciamento de projetos para dentro do seu editor de código. Gerencie quadros Kanban, controle tempo, execute sprints, escreva páginas de wiki e colabore com sua equipe — tudo sem sair do VS Code, Cursor, Windsurf ou qualquer fork compatível.

O Problema que Isso Resolve

Alternar entre seu editor de código e uma ferramenta de gerenciamento de projetos no navegador quebra o foco. Cada troca de contexto custa minutos de produtividade e energia mental. Desenvolvedores perdem o fluxo ao verificar detalhes de tarefas, registrar tempo ou atualizar status em uma aplicação separada.

O GitScrum Studio elimina essa fricção. Suas tarefas, quadros, sprints, controle de tempo e comunicação com a equipe ficam ao lado do seu código, na mesma janela onde você já passa o dia.

O que Você Está Vendo

Após instalar a extensão, um ícone do GitScrum aparece na Barra de Atividades (a faixa vertical de ícones no lado esquerdo do seu editor). Ao clicar nele, a barra lateral do GitScrum é exibida com uma navegação em árvore organizada por workspace e projeto.

A estrutura da barra lateral segue esta hierarquia:

Nome do Workspace
  └─ Nome do Projeto
       ├─ Planejar
       │    ├─ Sprints
       │    ├─ User Stories
       │    └─ Team Standup
       ├─ Construir
       │    └─ Board
       ├─ Conhecimento
       │    ├─ Wiki
       │    ├─ Discussões
       │    └─ Documentos
       └─ Controle de Tempo

Cada item abre um painel webview dedicado dentro do seu editor. Esses painéis se comportam como abas do editor — você pode dividir, reorganizar e fixá-los ao lado do seu código.

Instalação

Pelo Marketplace

1. Abra o VS Code, Cursor ou Windsurf
2. Vá até a aba de Extensões (Ctrl+Shift+X / Cmd+Shift+X)
3. Pesquise por GitScrum Studio
4. Clique em Install

Alternativamente, instale diretamente pelo Visual Studio Marketplace.

Pela Paleta de Comandos

1. Abra a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P)
2. Digite ext install gitscrum-vscode.gitscrum-vscode
3. Pressione Enter

A extensão é ativada automaticamente após a instalação. Não é necessário reiniciar o editor.

Autenticação

O GitScrum Studio requer autenticação para se conectar à sua conta GitScrum.

Fazer Login

1. Clique no ícone do GitScrum na Barra de Atividades
2. Clique em Sign in na barra lateral
3. Uma janela do navegador abre na página de autenticação do GitScrum
4. Faça login usando seu método preferido: GitHub, Google, Facebook ou Email
5. Após a autenticação bem-sucedida, o navegador redireciona de volta e a extensão se conecta automaticamente

Seu token de autenticação é armazenado de forma segura usando a API SecretStorage nativa do editor. Ele persiste entre sessões — você não precisa fazer login toda vez que abrir o editor.

Fazer Logout

Abra a Paleta de Comandos e execute GitScrum: Sign Out. Isso limpa suas credenciais armazenadas imediatamente.

Status da Autenticação

A barra lateral mostra o status da sua conexão. Quando autenticado, a árvore de workspaces e projetos aparece. Quando desconectado, um prompt de login é exibido.

Selecionando um Workspace e Projeto

Após fazer login:

1. A barra lateral carrega seus workspaces disponíveis
2. Expanda um workspace para ver seus projetos
3. Clique em um projeto para defini-lo como ativo
4. A árvore da barra lateral é preenchida com as seções Planejar, Construir, Conhecimento e Controle de Tempo desse projeto

Você pode trocar de projeto a qualquer momento clicando em um projeto diferente na árvore. O projeto ativo determina quais dados aparecem em todos os painéis.

Comandos Disponíveis

Abra a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P) e digite "GitScrum" para ver todos os comandos disponíveis:

O Cronômetro na Barra de Status

Um indicador persistente de controle de tempo aparece na barra de status na parte inferior do seu editor. Quando um cronômetro está em execução, ele mostra o tempo decorrido e o nome da tarefa atual. Clique nele para acessar os controles do cronômetro através de um menu QuickPick:

• Iniciar Cronômetro: Selecione uma tarefa e comece a registrar
• Parar Cronômetro: Pare o cronômetro ativo e registre a entrada
• Cancelar Cronômetro: Descarte o cronômetro ativo sem registrar

O cronômetro persiste entre sessões do editor. Se você fechar e reabrir seu editor, um cronômetro ativo continua de onde parou.

Navegando pela Extensão

Abrindo Painéis

Clique em qualquer item na árvore da barra lateral para abrir seu painel. Os painéis abrem como abas do editor:

• Board abre o quadro Kanban com todas as colunas e tarefas
• Sprints abre a lista de sprints com busca e filtros
• User Stories abre a lista de user stories
• Team Standup abre o fluxo de standup assíncrono
• Wiki abre o editor da base de conhecimento
• Discussions abre os canais de chat da equipe
• Documents abre o navegador de arquivos
• Time Tracking abre o painel de controle de tempo do projeto

Comportamento dos Painéis

Os painéis se comportam como abas padrão do editor. Você pode:

• Dividir painéis lado a lado com arquivos de código
• Fixar painéis para mantê-los abertos
• Fechar painéis com Ctrl+W / Cmd+W
• Reabrir painéis pela barra lateral ou Paleta de Comandos

Os dados são atualizados automaticamente no intervalo configurado. Clique no botão de atualizar no cabeçalho de qualquer painel para uma atualização imediata.

Atalhos de Teclado

A extensão não substitui nenhum atalho padrão do editor. Todos os comandos são acessíveis pela Paleta de Comandos. Você pode configurar atalhos de teclado personalizados para qualquer comando do GitScrum através do editor de Atalhos de Teclado (Ctrl+K Ctrl+S / Cmd+K Cmd+S).

Compatibilidade

O GitScrum Studio funciona com:

• VS Code 1.85.0 ou posterior
• Cursor (todas as versões)
• Windsurf (todas as versões)
• Qualquer editor baseado na API de extensões do VS Code

A extensão requer uma conexão ativa com a internet para se comunicar com a API do GitScrum.

Dicas Avançadas (Quando Estiver Familiarizado)

• Visualização dividida: Abra o quadro Kanban em um painel dividido ao lado do seu código. Arraste tarefas para "Done" conforme as conclui, sem trocar de janela.

• Fluxo do cronômetro: Inicie o cronômetro pela barra de status quando pegar uma tarefa. Leva apenas um clique e gera registros de tempo precisos sem esforço.

• Acesso rápido: Fixe painéis usados com frequência (Board, Time Tracking) para que persistam entre sessões do editor.

• Paleta de Comandos primeiro: Aprender os comandos GitScrum: permite acessar qualquer funcionalidade em segundos sem usar o mouse.

Permissões

A extensão respeita as permissões da sua conta GitScrum:

• Agency Owners e Managers: Acesso total a todas as funcionalidades, configurações e dados da equipe
• Desenvolvedores: Podem gerenciar tarefas, registrar tempo e contribuir com ferramentas de colaboração
• Clientes: Acesso somente leitura (se tiverem acesso ao projeto)

Se uma funcionalidade parecer desabilitada ou um painel mostrar dados limitados, verifique seu papel no projeto na aplicação web do GitScrum.

Como Reportar um Problema ou Solicitar uma Funcionalidade

Se a extensão se comportar de forma inesperada ou você tiver sugestões de melhorias, queremos saber.

Na barra lateral da aplicação web do GitScrum, clique em Support Tickets e abra um chamado descrevendo sua experiência. Inclua a versão da extensão (visível na aba de Extensões) e o nome e versão do seu editor para uma resolução mais rápida.