GitViz

Visualize o histórico do Git e logs de commit com animações, tornando as operações do Git intuitivas e fáceis de entender.

GitHub

Documentação

GitViz MCP: Log e Histórico Animados

Uma extensão poderosa para VS Code que visualiza o histórico do Git e logs de commits com animações, tornando as operações do Git intuitivas e fáceis de entender.

💬 Envie Seu Feedback

Ajude-nos a melhorar! Compartilhe suas opiniões, sugestões ou problemas através dos nossos formulários de feedback:

Seu feedback faz a diferença. Lemos todas as submissões. 🙏

🚀 Potencialize o Copilot com Comandos Git

Quer que o Copilot entenda melhor o Git? 🤖✨ Basta usar #get_git_prompt!

Isso ajuda o Copilot a gerar sugestões mais inteligentes para tarefas relacionadas ao Git.

Experimente algo assim:

#get_git_prompt What is the commit message of the latest commit?

Recursos

Animações Antes/Depois: Visualize como operações do Git como merge, rebase e cherry-pick transformam sua árvore de commits.
Controles Interativos: Reproduza e pause animações.
Estrutura de Branches: Visualização clara das relações entre branches e pontos de merge.
Destaque de Commits: Clique para destacar commits específicos na árvore.
Atualizações em Tempo Real: Reflete automaticamente as mudanças no seu diretório de trabalho.
Integração com Modelos de Linguagem: Ferramentas integradas para análise e assistência do Git.
Detecção Inteligente de Repositórios: Detecta e alterna automaticamente entre repositórios.
Comandos Git Aprimorados: Ferramentas de IA integradas para um fluxo de trabalho Git melhor.

Uso

Instale a Extensão GitViz MCP

Você pode instalar a extensão de uma das seguintes formas:

Pelo VS Code Marketplace

Pesquise por "GitViz MCP" na visualização de Extensões do VS Code (Ctrl+Shift+X / Cmd+Shift+X) e clique em Instalar.

Instalação Manual

Baixe o arquivo .vsix dos releases.
Abra o VS Code.
Execute Extensions: Install from VSIX... pela Paleta de Comandos.
Selecione o arquivo .vsix baixado.

Configure de Acordo com Seu Ambiente

Para Usuários do Copilot:

Recomenda-se usar a extensão diretamente, pois a configuração do MCP Server geralmente não é necessária.

Se ainda precisar configurar manualmente o MCP Server, consulte o Copilot Config abaixo ou execute o comando gitVizMcp: Register MCP Server pela Paleta de Comandos do VS Code.
```
"servers": {
    "gitViz": {
        "type": "http",
        "url": "http://localhost:35555/gitviz/sse"
    }
}
```

Para Usuários do Cline:

Configure usando o Cline Config abaixo:

"mcpServers": {
    "gitViz": {
        "url": "http://localhost:35555/gitviz/sse",
        "transportType": "sse"
    }
}

Para Usuários do Cursor:

Esta extensão atualmente não suporta o Cursor.

Fluxo Operacional Básico

demo video

Abrindo o Visualizador Git

Pelo Editor: Clique no ícone de branch Git na barra de título do editor.
Pela Paleta de Comandos: Ctrl+Shift+P → digite "gitVizMcp: Open Git Log Viewer".

Operações Básicas

Selecionar Repositório: Use o comando "gitVizMcp: Set Repository" para escolher qual repositório visualizar.
Ver Animação: A interface mostrará os estados antes/depois das operações do Git.
Controlar Reprodução: Use o botão de reproduzir/pausar para controlar o tempo da animação.
Zoom e Navegação: Use os controles de zoom para explorar árvores de commits complexas.

Gerenciamento de Repositórios

Modo Automático: Alterna automaticamente o repositório com base no arquivo aberto atualmente.
Seleção Manual: Escolha um repositório específico entre as opções disponíveis.
Múltiplos Workspaces: Suporta workspaces com múltiplas raízes.

Outras Configurações e Ferramentas

Configurações Disponíveis

Configuração	Padrão	Descrição
`gitVizMcp.port`	`35555`	Porta para o servidor MCP
`gitVizMcp.basePath`	`"/gitviz"`	Caminho base para endpoints da API
`gitVizMcp.maxGitLogEntries`	`30`	Número máximo de entradas de log do git a buscar.

Nota: Se você alterar as configurações gitVizMcp.port ou gitVizMcp.basePath, também deve atualizar a URL na configuração do seu MCP Server (por exemplo, Copilot Config ou Cline Config) para corresponder aos novos valores.

Comandos

Comando	Descrição
`gitVizMcp: Open Git Log Viewer`	Abre a interface principal de visualização
`gitVizMcp: Set Repository`	Seleciona qual repositório visualizar
`gitVizMcp: Register MCP Server`	Registra o servidor MCP nas configurações do VS Code
`gitVizMcp: Restart Server`	Reinicia o servidor MCP

Ferramentas de Modelo de Linguagem

Esta extensão fornece ferramentas de IA para uma experiência Git aprimorada:

highlight_commit: Destaca commits específicos na visualização
get_git_log: Recupera o histórico do Git para análise
visualize_git_log: Cria visualizações antes/depois de operações do Git
get_git_prompt: Acessa modelos de assistência Git-GPT

Requisitos

VS Code: Versão 1.99.0 ou superior
Git: Deve estar instalado e acessível pela linha de comando

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.