Merse Codex

A extensão oficial da Merse, criada para acelerar sua produtividade dentro do VS Code.

🚀 Funções principais

✨ Gerar código

Use comandos naturais para criar trechos de código em qualquer linguagem.

🔧 Refatorar código

Melhore, limpe e organize funções e arquivos com um único comando.

🧠 Explicar código

Peça explicações detalhadas de qualquer trecho do seu projeto.

🎨 Conversão HTML → React

Transforme HTML comum em componentes React modernos e organizados.

🛠 Como usar

1. Abra o menu lateral “Merse Codex”.
2. Digite um comando ou selecione um template rápido.
3. A IA gera, refatora ou explica seu código diretamente no editor.

🔮 Alimentado pelo Merse Codex API

A extensão se conecta ao backend da Merse para usar modelos inteligentes otimizados para programação.

Login (recomendado)

Para usar as automações, faça login pelo Merse Codex (tela de autenticação da extensão).

Login por email/senha (backend no Render)

O backend publicado no Render expõe POST /auth/login. Configure no serviço:

• MERSE_LOGIN_EMAIL
• MERSE_LOGIN_PASSWORD
• MERSE_CODEX_API_KEY (token que será retornado no login; não é chave do OpenAI/Replicate)

Login por Firebase (email/senha)

Se você quiser autenticar pelo Firebase Auth (Email/Senha), configure:

• merseCodex.firebaseApiKey nas Settings do VS Code

O login chama o endpoint do Firebase Identity Toolkit e salva o idToken localmente na extensão.

Login via navegador (URL custom)

Para testes locais, você pode apontar o login do navegador para:

• merseCodex.authUrl (ex.: https://merse.ia.br/auth/vscode)

Login por deep link (token)

Se o Merse gerar um link, você pode usar:

• vscode://merse.codex/auth?token=...

Ou colar o link/token direto na tela de login da extensão (Entrar com link).

Configuração de APIs e Segredos

Importante: por segurança, nenhuma chave de API sensível é publicada junto com a extensão. Este projeto está configurado para usar somente o backend do Render, sem leitura de arquivos de ambiente locais. Não use .env.local para chaves da extensão: configure tudo no Render (Service > Environment).

No Render, configure as variáveis de ambiente do backend:

MERSE_CODEX_API_KEY=...
MERSE_LOGIN_EMAIL=...
MERSE_LOGIN_PASSWORD=...
OPENAI_API_KEY=...
OPENAI_MODEL=gpt-5.2
OPENAI_MODEL_SIMPLE=gpt-5-mini
OPENAI_MODEL_MEDIUM=gpt-5.2
OPENAI_MODEL_INTELLIGENT=gpt-5.2-codex
OPENAI_MAX_OUTPUT_TOKENS=8192
REPLICATE_API_TOKEN=...
MERSE_REPLICATE_IMAGE_MODEL=3mgalaxia/merse-gerador-de-imagem
MERSE_REPLICATE_VIDEO_MODEL=3mgalaxia/merse-video-engine

Perfis de inteligência do runPrompt:

• simple: foco em resposta rápida e alteração pontual (sem sugestões automáticas de terminal).
• medium: equilíbrio entre velocidade e qualidade, com suporte a sugestões de terminal.
• intelligent: antes de editar, gera um checklist completo do que precisa ser feito e só depois começa a aplicar código (mais lento, porém mais estratégico).

No retorno do Cosmic Prompt, o sistema envia um resumo curto do que foi feito, com linguagem adaptada ao jeito do usuário (informal ou técnico), para economizar tokens e melhorar compreensão.

Na extensão, mantenha merseCodex.apiBaseUrl apontando para:

https://merse-codex-backend.onrender.com

Assim, todas as APIs ficam centralizadas e protegidas no backend do Render.

Deploy no Render

Este repositório já inclui render.yaml.

1. Conecte o repositório no Render.
2. Crie o serviço via Blueprint.
3. Preencha as variáveis sensíveis (sync: false) no painel do Render.
4. Faça push para publicar atualizações do backend.

👽 Sobre a Merse

A Merse é uma plataforma de IA avançada para criação de sites, geração de imagens, edição de HTML e automação de código.

Desenvolvido com 💜 por Matheus Miranda (Mirse/Merse).