Instalação e uso no desktop

Aprenda a instalar o Remy, entrar na sua conta, configurar um projeto, executar tarefas, revisar resultados e manter o aplicativo atualizado. Para um passo a passo completo da sua primeira tarefa de programação, consulte Início rápido.

flowchart LR
    A["Download and install"] --> B["Sign in"]
    B --> C["Add a project"]
    C --> D["Start a task"]
    D --> E["Review results"]
    E --> F["Refine or deliver"]

1. Antes de começar

1.1 Escolha o instalador correto

A página de downloads também oferece Linux. Este guia abrange macOS e Windows.

No Mac, abra menu Apple → Sobre Este Mac para conferir o chip ou processador. No Windows, vá a Configurações → Sistema → Sobre → Tipo de sistema para conferir a arquitetura.

1.2 Prepare sua conta e seu projeto

Seu projeto tem seus próprios requisitos de execução. O aplicativo desktop inclui o ambiente de execução de que o Remy precisa, portanto você não precisa instalar Python ou Node.js para usar o Remy. Se seu projeto exigir essas ferramentas, configure-as de acordo com a documentação dele.

2. Baixe e instale

Obtenha o instalador na página de downloads do Remy. Escolha a versão para seu sistema operacional e chip, conforme a lista acima.

2.1 macOS

1. Baixe o DMG para o chip do seu Mac.
2. Clique duas vezes no DMG e siga as instruções da janela de instalação para mover o Remy para Aplicativos.
3. Abra o Remy pela pasta Aplicativos.

Confira a instalação: O Remy abre na tela de login ou no espaço de trabalho, se você já estiver conectado.

2.2 Windows

1. Baixe o instalador Windows x64 EXE.
2. Clique duas vezes nele e siga o assistente de instalação.
3. Escolha uma pasta de instalação e conclua a configuração.
4. Abra o Remy pelo menu Iniciar.

Confira a instalação: O Remy abre na tela de login ou no espaço de trabalho.

2.3 Confira se está tudo pronto

• O instalador corresponde ao sistema operacional e ao chip do computador.
• O aplicativo abre corretamente.
• Clicar em Começar abre a página de login no navegador padrão.

Se o instalador não abrir ou o aplicativo não iniciar, consulte o problema correspondente na seção 7.

3. Entre na sua conta e conheça a interface

3.1 Entre na sua conta

1. Abra o Remy e clique em Começar.
2. Conclua o login no navegador padrão.
3. Volte ao Remy para acessar seu espaço de trabalho.

Enquanto aguarda o login pelo navegador, o aplicativo exibe Continue o login pelo navegador.

Para recomeçar, clique em Cancelar login e depois em Começar. Se o login falhar, use a mensagem exibida para conferir sua conexão ou tentar entrar novamente.

3.2 Encontre os principais controles

Abrir configurações: Clique na sua conta na parte inferior da barra lateral e escolha Configurações. Para sair, escolha Sair no menu da conta.

4. Trabalhe com projetos e conversas

4.1 Adicione um projeto existente

1. Abra o seletor de projetos e clique em Novo projeto.
2. Digite um Nome do projeto na caixa de diálogo Criar projeto.
3. Em Pastas de origem, clique em Adicionar pastas que o agente pode ler e editar e selecione a pasta local que contém seu código.
4. Confira o nome e a pasta e clique em Criar projeto.
5. Clique em Nova conversa nesse projeto para começar a trabalhar.

Na maioria dos casos, escolha a pasta raiz do projeto: aquela que contém a documentação, o código-fonte e a configuração de build. Por exemplo:

example-project/       ← Adicione esta pasta
├── README.md
├── package.json       ← Ambiente e dependências do projeto (exemplo)
├── src/
└── tests/

Esta é uma estrutura de pastas de exemplo. Os nomes reais dos arquivos dependem do seu projeto.

Pastas de origem são as pastas de projeto que o Remy pode ler e editar. Confira se selecionou o projeto pretendido antes de criá-lo e descreva o escopo de cada tarefa no prompt.

4.2 Use mais de uma pasta

Se o frontend e o backend estiverem em pastas separadas, por exemplo, clique em Adicionar pasta em Pastas de origem para incluir as duas.

Ao acrescentar requisitos, indique as pastas envolvidas para que o Remy não precise deduzi-las pelos nomes.

Este projeto tem pastas separadas para frontend e backend.
Confira se os parâmetros enviados pelo frontend correspondem às regras de validação do backend.
Liste os arquivos relevantes e quaisquer diferenças.
Apenas analise. Não edite arquivos.

4.3 Inicie uma nova conversa ou continue uma existente

Confira o nome e a pasta do projeto atual antes de iniciar uma tarefa. Em uma nova conversa, descreva novamente o objetivo e as restrições.

5. Execute tarefas e revise resultados

5.1 Escolha um modelo e descreva a tarefa

Escolha um modelo disponível ao lado da caixa de mensagem e ajuste as configurações de raciocínio quando oferecidas. Você também pode selecionar Dynamic para deixar o Remy escolher um modelo e passar a um mais potente se a tarefa ficar travada. O modelo selecionado automaticamente não é exibido para você.

Atualmente, os usuários não podem trocar de modelo manualmente enquanto uma tarefa está em execução. Consulte as opções exibidas no aplicativo para ver os modelos e as configurações de raciocínio disponíveis.

Dê ao Remy uma tarefa clara de executar e fácil de verificar:

5.2 Experimente um modelo de tarefa

Adapte os recursos e os comportamentos destes exemplos ao seu próprio projeto.

Encontre e corrija um bug

Quando altero o filtro de status na página 3 da lista de pedidos, a lista parece vazia.
Os resultados só aparecem depois que volto à página 1.

Encontre a causa e redefina o número da página quando o filtro mudar.
Adicione e execute os testes relevantes.
Altere somente a lógica relacionada e resuma os arquivos alterados, os resultados das verificações e quaisquer verificações que não conseguiu concluir.
Ainda não faça commits nem envie código.

Revise alterações existentes sem editar

Revise as alterações atuais sem commit.
Concentre-se nas interações entre filtragem, paginação e ordenação e em quaisquer casos extremos não cobertos.

Liste os problemas por gravidade, com localizações nos arquivos, condições de ocorrência e sugestões de correção.
Ainda não edite arquivos, faça commits nem envie código.

Para uma primeira tarefa de programação completa, consulte Início rápido.

5.3 Acrescente contexto enquanto trabalha

Se o Remy pedir mais informações ou confirmação, leia a solicitação antes de responder. Quando os requisitos mudarem, explique o novo escopo na mesma conversa.

Mais uma restrição: mantenha esta alteração no frontend. Não altere a API.
Se sua abordagem exigir uma alteração na API, explique o motivo e descreva o impacto, depois aguarde minha confirmação.

5.4 Revise arquivos e alterações

• Use o Explorador para navegar pelos arquivos do projeto e abrir o que deseja inspecionar.
• Use Alterações para revisar as alterações na árvore de trabalho do Git. Selecione um arquivo para ver o que foi adicionado, removido ou editado.
• Se esses painéis não estiverem abertos, escolha Explorador ou Alterações no menu de adição de painéis.

Alterações mostra a árvore de trabalho atual do Git. Ela pode incluir trabalho sem commit que já existia antes do início da tarefa. Separe essas alterações do trabalho feito nesta tarefa. Uma pasta fora de um repositório Git não tem diff em relação ao HEAD; inspecione seus arquivos e o resumo da tarefa diretamente.

5.5 Confira se a tarefa está concluída

Se o resultado precisar de mais trabalho, descreva o problema específico na conversa original. Por exemplo:

Depois que altero um filtro, o número da página volta a 1, mas a lista não é atualizada.
Ela deve solicitar dados novos assim que o filtro mudar.

Corrija somente esse problema, adicione e execute os testes relevantes
e resuma a alteração e os resultados das verificações. Ainda não faça commits nem envie código.

6. Atualize o Remy

6.1 Confira sua versão

No macOS, abra Remy → Sobre o Remy para ver a versão do aplicativo.

Na caixa de diálogo de feedback, você também pode passar o mouse sobre Informações incluídas automaticamente para ver a Versão do Remy e outras informações incluídas no relato.

6.2 Verifique se há atualizações

Você pode ver uma destas mensagens:

6.3 Instale uma atualização

1. Salve seu trabalho e confira se alguma tarefa continua em execução.
2. Depois do download da atualização, escolha Instalar atualização no aviso de atualização ou clique em Reiniciar para atualizar na barra lateral.
3. Siga as instruções para concluir a instalação e reabrir o aplicativo.

Se o Remy informar que uma tarefa ainda está em execução, conclua esse trabalho antes de reiniciar para atualizar.

7. Solução de problemas e limitações conhecidas

7.1 Problemas de instalação, login e tarefas

7.2 Limitações conhecidas

• Os usuários não podem trocar de modelo manualmente enquanto uma tarefa está em execução; o Dynamic pode passar a um modelo mais potente automaticamente.
• Ramificar cria uma nova ramificação da conversa; não desfaz alterações nos arquivos.
• O Browser Use e o Computer Use atualmente oferecem suporte apenas ao macOS.
• Ao trabalhar em um projeto local, mantenha o computador, o Remy e o ambiente necessário para a tarefa disponíveis. Consulte o guia do Cloud para tarefas na nuvem.

8. Obtenha ajuda e explore mais

8.1 Relate um problema

1. Abra o menu da conversa relevante e escolha Enviar feedback.
2. Em Enviar feedback ao Remy, escolha um tipo de feedback e um nível de impacto e descreva o problema.
3. Adicione capturas de tela ou anexos conforme necessário e clique em Enviar feedback.

Você também pode clicar com o botão direito em uma conversa na barra lateral e escolher Enviar feedback.

Descreva como reproduzir o problema, o que você esperava e o que aconteceu. Inclua mensagens de erro ou capturas de tela relevantes.

8.2 Avalie uma resposta

Use o botão de gostei ou não gostei abaixo de uma resposta e explique o que ajudou ou não atendeu às suas expectativas. O objetivo da tarefa, o problema encontrado e o resultado esperado nos ajudam a entender o que melhorar.

Se não encontrar a opção de feedback ou não conseguir abrir o aplicativo, entre em contato com o suporte em support@corepass.com.

8.3 Continue explorando