Do zero ao
primeiro diff.

Dez minutos, um projeto real. Este fluxo cobre autenticação, inicialização do projeto e o ciclo completo de uma mudança: perguntar, planejar, aplicar, desfazer.

01Conecte um provedor

Abra o MVCode em qualquer diretório e rode o comando de conexão:

/connect

Escolha o provedor, cole a chave de API e pronto — a credencial fica criptografada no auth store local, nunca em texto plano na config. Se preferir não gerenciar chaves, o MVCode+ traz modelos hospedados com cota integrada.

02Inicialize o projeto

1. Entre no diretório e abra o MVCode
   terminal

   cd ~/projetos/meu-app
   mvcode

2. Rode /init

   O agente analisa a estrutura do projeto e cria um AGENTS.md na raiz — as regras permanentes que todo agente vai ler.

   dentro da TUI

   /init

3. Commite o AGENTS.md

   Ele é parte do projeto: versionado, revisável e compartilhado com o time. Regras →

03Pergunte antes de mudar

Use @ para buscar arquivos por nome difuso e compor contexto exato:

Como a autenticação é tratada em @src/api/index.ts?

O agente responde citando o código real — útil para navegar partes do projeto que você não escreveu. Referências →

04Planeje, depois construa

Para mudanças com mais de um passo, comece no modo plan — ele desabilita edições e devolve um plano de implementação. Alterne com Tab; o indicador aparece no canto inferior direito.

Quando o usuário excluir uma nota, marque como excluída no banco.
Crie uma tela de notas excluídas recentemente, com restaurar
e excluir de vez.

Itere no plano como falaria com alguém do time — contexto e exemplos melhoram o resultado. Você pode arrastar imagens para o terminal e referenciá-las no prompt. Quando o plano estiver bom, volte ao modo build com Tab e mande executar.

05Revise e desfaça

Cada edição chega como diff na timeline — você vê linha a linha o que mudou. Se o resultado não for o que queria:

/undo
# reverte a última mudança e devolve o seu prompt original
/redo

/undo pode ser repetido para voltar vários passos — as mudanças são snapshots, não texto perdido.

06Compartilhe, se quiser

Sessões podem virar um link somente leitura para o time — nada é compartilhado por padrão:

/share

Compartilhamento e review →