Docs/Superfícies do produto/IDE (extensão VS Code)

O MVCode dentro
do editor.

A extensão para VS Code e forks coloca a sessão na activity bar: timeline, review e aprovações sem sair do editor. É uma superfície planejada — esta página documenta o que está sendo preparado, com o status honesto.

PlanejadoHow-to /ide1 min de leitura

Planejado — não publicada

A extensão ainda não está disponível para instalação. Nenhum marketplace a lista neste momento. O caminho suportado hoje dentro do editor é o ACP — ou a TUI no terminal integrado.

01Arquitetura: cliente fino do runtime

Como o mobile e a web, a extensão não roda o agente dentro do host — ela é um cliente do servidor MVCode:

Servidor local por workspace — a extensão sobe (ou reusa) uma instância local, identificada como chamada de editor (MVCODE_CALLER=vscode).
Servidor remoto por pareamento — device-code curto, digitado na máquina que executa; o código expira e a credencial fica no keychain do editor.
Mesmo estado das outras superfícies — a sessão aberta na extensão é a mesma da TUI, do app e do celular.

Viewactivity bar · 340px

CallerMVCODE_CALLER=vscode

Pareamentodevice-code · expira

Statusplanejada · em preparação

02As superfícies planejadas

SidebarView de sessãoÁrvore de sessões do workspace, timeline em tempo real e composer — na activity bar, com o indicador diagonal da casa.

PanelReview em largura amplaArquivos alterados e diff no painel inferior — onde review de código sempre morou no editor.

Status barEstado sempre à vistaItem permanente: conectado, RUN, permissão pendente, offline — com contagem no ícone da activity bar.

SeleçãoCódigo vira contextoSelecionou no editor, um hint discreto envia o trecho à sessão como referência de arquivo e linhas.

Permissões e perguntas do agente chegam como notificações nativas do editor — a mesma semântica de aprovação do celular.

03Estados sem maquiagem

Estado	Comportamento planejado
desconectado	A view oferece as duas saídas: iniciar servidor local ou parear com remoto.
streaming	Turno ao vivo na timeline; parar sempre a um clique.
permissão	Badge na activity bar + notificação; o dock de decisão abre na view.
offline	Banner de reconexão; composer bloqueado até o servidor voltar.
401	Credencial expirada — a view pede novo pareamento, sem loop silencioso.

04Convivência com o ACP

A extensão e o ACP não competem: o vínculo ACP aparece declarado na própria view quando o editor o usa, e o runtime é o mesmo. A extensão adiciona o que o protocolo não cobre — review no panel, status bar, notificações e captura de seleção.

05Enquanto não chega

ACP — o MVCode em editores compatíveis, hoje.
TUI no terminal integrado — a experiência completa, dentro do editor.
Web — a interface embarcada em uma aba ao lado.

Quando a extensão for publicada, esta página troca o badge — e nada além do badge — para refletir o lançamento. Anúncios saem nas release notes.