Um binário.
Sem dependências.
O MVCode é distribuído como um binário monolito: TUI, servidor HTTP e interface web embarcados em um único executável. Instalar é copiar um arquivo para o lugar certo — o script faz isso por você.
01Pré-requisitos
- Um emulador de terminal moderno — WezTerm, Ghostty, Alacritty ou Kitty são boas escolhas.
- Uma forma de alimentar modelos: chave de API de um provedor BYOK ou um plano MVCode+.
02macOS e Linux
O script de instalação detecta o sistema, baixa o artefato mvcode-<alvo> correto e instala em ~/.maxvision-code/bin/.
# [[INSTALL_URL]] · placeholder de handoff — substituir pela URL oficial antes de publicar curl -fsSL [[INSTALL_URL]] | bash
Depois, confirme que o binário responde:
mvcode --version mvcode 2026.7.0
Se o comando não for encontrado, garanta que ~/.maxvision-code/bin está no seu PATH — o script adiciona a linha ao seu profile, mas o terminal precisa ser reaberto.
03Windows
O MVCode roda nativamente no Windows — incluindo correções exclusivas da casa, como colagem de imagens da área de transferência no terminal. Para a melhor experiência, porém, recomendamos o WSL.
mvcode-windows-x64.zip da release, extraia e adicione ao PATH.04Instalação manual
Cada release publica artefatos por plataforma no padrão mvcode-<alvo>.tar.gz (ou .zip no Windows). Baixe, extraia e mova o binário:
tar -xzf mvcode-linux-x64.tar.gz mkdir -p ~/.maxvision-code/bin && mv mvcode ~/.maxvision-code/bin/
| Plataforma | Artefato |
|---|---|
| macOS (Apple Silicon) | mvcode-darwin-arm64.tar.gz |
| macOS (Intel) | mvcode-darwin-x64.tar.gz |
| Linux x64 | mvcode-linux-x64.tar.gz |
| Linux arm64 | mvcode-linux-arm64.tar.gz |
| Windows x64 | mvcode-windows-x64.zip |
05Atualização
O próprio binário se atualiza para a última versão do seu canal:
mvcode upgradePara fixar uma versão específica, passe a versão como argumento — útil em CI e frotas gerenciadas por policies.
06Ambientes sem internet
Para redes restritas e máquinas air-gapped, o MVCode tem um bundle offline com dependências pré-resolvidas e política de rede endurecida. Implementado
Se você já tinha o opencode instalado, o MVCode convive com ele sem conflito — binários, diretórios de dados e configs são separados. Na primeira execução, o MVCode migra automaticamente o diretório legado opencode para maxvision-code e continua lendo opencode.json{,c} como fallback de configuração.