Documentação

Como colocar o agente do vsgo para trabalhar.

Última atualização: 31 de agosto de 2026

O vsgo é uma IDE com IA derivada do Code – OSS. O agente roda com as suas chaves de API ou com modelos locais. Não há conta, assinatura nem backend do projeto no meio do caminho.

Instalação

Baixe o instalador do seu sistema na página de releases.

SistemaArquivo
WindowsvsgoUserSetup-x64-<versão>.exe, não pede senha de administrador
Ubuntu / Debianvsgo_<versão>_amd64.deb
Linux (qualquer distro)vsgo-<versão>-linux-x64.tar.gz

Primeiros passos

  1. Abra a paleta de comandos (Ctrl+Shift+P) e rode Agent Chat: Add API Key... para cadastrar a chave do seu provedor.
  2. Sem chave? Rode Agent Chat: Gerenciar Modelos Locais e baixe um modelo para rodar na sua máquina.
  3. Descreva a tarefa no chat. O agente lê o repositório, propõe as mudanças e pede confirmação antes de escrever arquivos ou rodar comandos.

Provedores

Anthropic, OpenAI, Google Gemini, DeepSeek, Groq, Mistral, xAI, Ollama e qualquer endpoint compatível com a API da OpenAI. A chave fica no cofre de credenciais do sistema operacional e a requisição vai direto da sua máquina ao provedor, veja a Política de Privacidade.

Comandos relacionados: Agent Chat: Add API Key..., Agent Chat: List Configured Providers, Agent Chat: Remove API Key....

Modelos locais

O comando Agent Chat: Gerenciar Modelos Locais detecta o seu hardware, sugere modelos compatíveis, faz o download e sobe o servidor de inferência. Nesse modo nenhum dado sai do computador. Para desligar o servidor, use Agent Chat: Parar o Servidor de Modelos Locais.

Regras de projeto

Crie arquivos .agents/rules/*.md com frontmatter para definir o comportamento do agente por pasta e por tipo de arquivo:

---
description: Idioma padrão
alwaysApply: true
---
Responda em português brasileiro.

Use alwaysApply: true para regras globais, ou um padrão glob para aplicar só a certos arquivos. Depois de editar, rode Agent Chat: Reload Rules.

Memória

O que o agente aprende sobre o projeto persiste entre sessões. Gerencie com Agent Chat: Add Memory... e Agent Chat: Forget Memory..., ou pela árvore de memória na barra lateral.

Agentes em paralelo

Agent Chat: New Agent... cria um agente numa branch isolada via git worktree, ele trabalha sem disputar a sua árvore de trabalho. Use Agent Chat: Promote Agent to Foreground para trazer um agente ao primeiro plano e Agent Chat: Refresh Agent Diff para revisar o que ele mudou.

Bug Bot

Revisão contínua em segundo plano, com os apontamentos como comentários inline no código. Ligue e desligue com Agent Chat: Toggle Bug Bot. Cada apontamento traz as ações Apply Fix e Dismiss.

Índice semântico

A busca por significado ajuda o agente a achar o código certo em repositório grande. Por padrão os embeddings são gerados localmente. Comandos: Reconstruir Índice Semântico, Mostrar Status do Índice Semântico e Escolher Provedor de Embeddings.

Servidores MCP

Conecte ferramentas externas pelo Model Context Protocol com Agent Chat: Servidores MCP. Cada servidor que você adicionar passa a receber os dados que a ferramenta dele exigir.

Outras funcionalidades

  • Split changes into PRs: Agent Chat: Split Working Tree into PRs... quebra a árvore de trabalho em pull requests agrupados por feature.
  • Figma: Agent Chat: Conectar à Figma dá ao agente acesso de leitura aos seus arquivos de design.

Onde continuar