MVCODEDocsv2026.7 · devAbrir o app
Docs/Começar/Migrar de Claude Code, Codex e OpenCode

Traga o seu
histórico junto.

Sessões são memória de trabalho. O MVCode importa conversas do Claude Code, do Codex e do opencode — com turnos, tool-calls e resultados — para que a troca de agente não custe o seu contexto.

Já implementado e entrando na documentaçãoHow-to /migrate1 min de leitura

01O que a importação cobre

OrigemFonte lidaO que entra
Claude Code~/.claude/projects/…Sessões por projeto: turnos, tool-calls e resultados, com ids determinísticos.
Codexsessões locais do CodexThreads completas, mapeadas para a timeline do MVCode.
opencodestorage local do opencodeSessões com paridade total — mesmo modelo de dados de origem.

A importação é idempotente: rodar de novo não duplica nada. Se a sessão de origem cresceu desde a última importação, apenas os turnos novos entram.

02Pela CLI

terminal
mvcode import --from claude-code
mvcode import --from codex
mvcode import --from opencode

O comando descobre as sessões da origem, mostra o que encontrou e grava no storage do MVCode. As sessões importadas aparecem na Home agrupadas como as demais.

03Pelo app e pela TUI

O mesmo fluxo existe nas interfaces: um picker lista as sessões detectadas de cada origem e importa a seleção. No app, procure Importar sessões nos diálogos de sessão; na TUI, via command palette.

Proveniência preservada

Cada sessão importada guarda a referência da origem. A timeline marca de onde o histórico veio, e reimportações usam essa referência para atualizar em vez de duplicar.

04Configuração e credenciais

  • Config — o MVCode lê maxvision-code.json{,c} e, como fallback, a sua config existente do opencode (módulo abaixo). Migre no seu ritmo.
  • Dados — na primeira execução, o diretório de dados legado opencode é migrado automaticamente para maxvision-code.
  • Credenciais — chaves de provedor não são importadas de outros agentes; reconecte com /connect. É deliberado: credencial não viaja em arquivo de sessão.
Compatibilidade · config opencode

A cadeia de configuração aceita opencode.json e opencode.jsonc como fallback, incluindo o $schema apontando para opencode.ai/config.json. Uma config existente continua válida sem edição — quando quiser, renomeie para maxvision-code.json e ela passa a ter precedência.

05Checklist pós-migração

  • mvcode sessions lista o histórico importado
  • Provedores reconectados via /connect
  • AGENTS.md revisado — regras antigas de outro agente podem não valer aqui
  • Atalhos e tema do seu jeito — atalhos · temas