Instale o Yenpo e abra seu primeiro repositório

Você não precisa de uma conta de modelo para começar a ler código no Yenpo. Navegação, busca e navegação por servidor de linguagem funcionam localmente. Conecte um provedor depois, quando quiser perguntar ao AI Reader sobre o código.

Confira seu Mac

A prévia Early Access atual funciona em Macs com Apple silicon e Intel, com macOS 14 ou posterior; um único download serve para ambos. Confira sua versão do macOS em About This Mac.

Cada versão de prévia expira em uma data fixa, exibida ao lado do botão de download. A data é definida ao gerar a versão, portanto baixar ou reinstalar depois não adia o prazo. Instale uma versão mais recente antes disso.

Instale

1. Baixe o .dmg na página inicial.
2. Abra-o e arraste Yenpo para Applications.
3. Inicie o Yenpo em Applications e ejete a imagem de disco.

Confira a versão instalada

Escolha Yenpo → About Yenpo na barra de menus. Compare a versão com a exibida ao lado do botão de download. A janela About também mostra a expiração do EAP no fuso horário do Mac; o site exibe a data em UTC.

Se você instalou uma atualização, mas ainda vê a versão antiga, encerre o Yenpo e reabra a cópia em Applications. Veja os passos de substituição em Atualize antes de a prévia expirar.

Abra um projeto

Abra a pasta do projeto que quer ler. Escolha a raiz do repositório, onde ficam o README, o arquivo de build e .git. Se abrir uma subpasta, testes e configurações de outros locais do repositório não farão parte do projeto.

Pressione Command-P (Go to File…), digite parte do nome ou caminho e abra um arquivo conhecido. Mantenha o README ou um teste relacionado em outra aba. Para ler outro projeto, abra-o em sua própria janela.

Não encontra um arquivo que sabe que existe? Confira se ele está dentro da pasta aberta e se arquivos ocultos ou ignorados pelo Git estão sendo escondidos. Veja os detalhes em Encontre arquivos e siga símbolos.

Experimente uma tarefa pequena

Escolha uma pergunta cuja resposta possa conferir, como onde uma configuração é lida:

1. Use Search All Files para encontrar o nome exato da configuração ou uma mensagem característica.
2. Abra a função encontrada e localize de onde vem a entrada.
3. Use Go to Definition ou Find References se houver um servidor de linguagem disponível. Caso contrário, busque o símbolo como texto.
4. Leia o chamador ou teste que fornece a entrada.

Isso basta para começar: um ponto de entrada, um valor para acompanhar e um chamador ou teste que mostre seu uso. Você não precisa entender toda a arquitetura primeiro.

Pergunte ao AI Reader (opcional)

Configure um provedor seguindo Conecte um provedor de modelos, abra o AI Reader e pergunte sobre o código que acabou de ler. Adicione um arquivo, pasta ou seleção como ponto de partida, ou descreva o comportamento e deixe-o encontrar o código no espaço de trabalho.

Por exemplo:

Rastreie esta configuração do valor padrão ao manipulador da requisição. Quais sobrescritas podem alterá-la? Mostre as ramificações que devo conferir.

Clique em uma referência da resposta para visualizar o código em Quick Look e em Open File para mantê-lo em uma aba. Confira uma afirmação no código antes de fazer uma pergunta maior.

O AI Reader apenas lê por padrão. Você pode permitir edições por uma única execução; O que é enviado e o que pode ser editado explica o funcionamento e o que vai para o modelo.

Atualize antes de a prévia expirar

1. Confira a versão e a expiração ao lado do botão de download da página inicial. Baixe o .dmg mais recente quando disponível.
2. Salve os arquivos pendentes e encerre o Yenpo. Abra a nova imagem de disco e arraste Yenpo para Applications, substituindo a cópia quando o Finder perguntar.
3. Inicie o Yenpo em Applications, confira Yenpo → About Yenpo novamente e ejete a imagem de disco.

Baixar ou reinstalar a mesma versão não estende sua validade. Se ela expirou e a página inicial ainda oferece essa versão, volte depois para conferir se há uma atualização.

Se algo não funcionar

Problema	Confira primeiro
Um arquivo não é encontrado	Raiz do projeto, caminho, opções de arquivos ocultos e ignorados pelo Git
Go to Definition não faz nada	Se o servidor de linguagem está instalado e entende o projeto
O AI Reader não responde	Provedor ativo, tipo de API, endpoint, ID do modelo e chave de API
O código não é o esperado	Se a aba mostra uma versão histórica do Git ou o arquivo atual

Ao registrar um bug, guarde as versões do Yenpo e macOS, os resultados esperado e real e os passos de reprodução. Não inclua código privado ou chaves de API no que compartilhar publicamente.

Escolha o próximo passo

Continue com Encontre arquivos, siga símbolos e confira referências. Comece pela busca de arquivos e use a navegação por símbolos quando houver servidor de linguagem. Também é possível comparar commits e branches sem conta de modelo.

Para perguntar ao AI Reader sobre o código, conecte um provedor de modelos. Antes de enviar uma pergunta, confira qual código é enviado ao provedor e as cobranças dele.