Saltar para o conteúdo principal
Um projeto é um conjunto de fontes de código mais as configurações do ambiente. Uma fonte pode ser um repositório do GitHub, uma pasta enviada para o servidor na nuvem ou uma pasta no seu computador. As sessões podem ser executadas dentro de um projeto ou fora de qualquer projeto.

Projetos na nuvem e projetos locais

  • Projeto na nuvem: o código fica no seu servidor na nuvem. Há três fontes: criar do zero, importar do GitHub ou enviar um projeto local. Requer o Plus.
  • Projeto local: vinculado a uma pasta em um dos seus computadores. As sessões são executadas nesse computador. Consulte Executar no seu dispositivo. Os arquivos não são enviados, e nenhum servidor na nuvem é necessário.
A barra lateral mostra os projetos em duas seções de acordo com esses tipos, e um projeto nunca passa para a outra seção depois de criado. No aplicativo web ou em outro computador, você pode ver os projetos locais e suas sessões e iniciar novas sessões neles, mas não pode ver arquivos e commits que não foram enviados para a nuvem.
Lista de projetos

A página de projetos lista todos os projetos do espaço de trabalho

Criar um projeto

Clique em + no título de uma seção da barra lateral, em New project na página de projetos ou em New project no menu de projetos acima da caixa de entrada da nova sessão. Se você criar um projeto na nuvem sem o Plus, a janela de assinatura abre primeiro. Depois de assinar, clique em Continue para voltar à janela de criação. Os repositórios que você já selecionou são mantidos.

Criar do zero

1

Digitar um nome

Até 64 caracteres. Se ficar vazio, será usado my-app.
2

Escolher um modelo inicial

Por exemplo Blank, Node · TypeScript, Next.js ou Python, conforme mostrado no app.
3

Criar

Se necessário, selecione Create a private GitHub repository (requer uma conta do GitHub conectada) e clique em Create project.

Importar do GitHub

1

Escolher repositórios

Selecione um ou mais repositórios. Se você selecionar mais de um, o primeiro é o repositório principal e os demais são clonados no projeto junto com ele.
2

Iniciar a criação

Clique em Get started. Quando terminar, você vai para a página de nova sessão com este projeto selecionado.
Novo projeto: importar do GitHub

Importando repositórios do GitHub

Se um repositório não aparecer na lista, clique em Configure access para ajustar a autorização no GitHub e depois clique em Refresh ao voltar. Se você ainda não conectou o GitHub, consulte Conectores.

Enviar um projeto local

Arraste uma pasta para a janela ou clique em Choose folder…, confirme a quantidade e o tamanho dos arquivos e clique em Get started. Os envios têm estes limites: 2 GiB no total, até 50.000 arquivos e 100 MiB por arquivo. O conteúdo listado em .gitignore, node_modules, .git, arquivos do tipo .env, além de credenciais, chaves privadas e certificados, é excluído automaticamente. Se um envio falhar ou for cancelado, a parte já enviada não é mantida, e uma nova tentativa começa do início. Projetos enviados não têm repositório remoto, então as alterações são entregues como um patch.
Navegadores móveis não conseguem selecionar pastas, então não é possível enviar um projeto local a partir de um celular.

Vincular uma pasta do seu computador

1

Escolher uma pasta

Na janela de novo projeto local, clique em Add abaixo da pasta de origem. O nome do projeto é preenchido com o nome da pasta, e você pode alterá-lo.
2

Criar

Clique em Create project para ir à página de nova sessão. O local de execução padrão é este computador.
Não é possível escolher pastas amplas demais, como a sua pasta pessoal, nem pastas que você não tem permissão para ler. Depois de criar o projeto, você pode adicionar outras pastas do mesmo computador nas configurações do projeto.
Apenas o aplicativo para desktop pode criar projetos locais.

Configurar o ambiente de um projeto na nuvem

O ambiente do projeto inclui o script de configuração, o comando de inicialização e os segredos e variáveis de ambiente que o projeto usa. A configuração é opcional. Você pode iniciar sessões assim que o projeto for criado. Projetos locais usam o ambiente do próprio computador e pulam esta etapa.
1

Abrir a página de configuração do ambiente

Em Project settings › Environment, clique no botão de edição. A página de configuração do ambiente é uma página separada no projeto e não aparece na lista de sessões.
2

Aguardar a IA gerar um rascunho

A IA lê o repositório e gera o script de configuração, o comando de inicialização e os segredos e variáveis necessários. Nenhum script é executado até você concluir a revisão.
3

Concluir as três etapas de revisão

Confirme o script de configuração e o comando de inicialização, preencha os segredos e preencha as variáveis de ambiente, nessa ordem. Depois de preencher os campos obrigatórios, clique em Finish review. Se você ainda não tiver os valores, clique em Respond later. Os valores já digitados são mantidos.
4

Publicar

A IA executa o script de configuração no servidor na nuvem. Quando ele passar, clique em Publish to cloud server e depois em Start a task para ir a uma nova sessão. Se falhar, clique em Retry ou Edit environment. Uma falha não impede que você inicie sessões.
Você pode continuar adicionando requisitos na caixa de entrada na parte inferior da página, e a IA reconfigura o ambiente de acordo. Depois de alterar um ambiente publicado, publique-o novamente para que as alterações entrem em vigor. Não envie segredos pela caixa de entrada. Digite-os nas etapas de revisão ou nas configurações de segredos.

Acompanhar o progresso na página do projeto

Abra um projeto para ver:
  • Recent sessions: sessões em andamento e aguardando sua aprovação ficam destacadas. Clique em View all para ver todas as sessões deste projeto.
  • Commits: commits recentes no branch atual. Abra um para ver os arquivos alterados e as linhas adicionadas e removidas.
  • Files: se uma pasta contiver um README, ele é exibido diretamente. Arquivos Markdown e similares podem alternar entre prévia e código-fonte, e podem ser copiados ou compartilhados. Arquivos sensíveis como .env e chaves privadas não são exibidos.
  • Website previews: serviços que este projeto está escutando no servidor na nuvem, por exemplo localhost:3000. Clique em Open para ver a prévia no app. Uma entrada aparece depois que você pede ao agente para iniciar um servidor de desenvolvimento. As prévias ficam indisponíveis quando o servidor na nuvem não está em execução.

Compartilhar uma prévia ou um arquivo

1

Abrir o compartilhamento

Clique em Share em uma prévia de site ou em Share file na visualização de arquivo.
2

Definir acesso e validade

Escolha Only me, Anyone with the link (padrão) ou Public. A validade vai de 1 a 30 dias (7 dias por padrão).
3

Copiar o link

Clique em Create link e depois em Copy link.
O link é exibido apenas uma vez e não pode ser visto novamente depois que você o fecha. Copie-o imediatamente. Antes de escolher Public, confirme que o conteúdo pode ser tornado público.
Em My shares, você pode revogar um link (ele para de funcionar imediatamente) ou compartilhar novamente um link expirado. Compartilhamentos que excedem o limite diário de tráfego são pausados e voltam no dia seguinte.

Alterar as configurações do projeto

Abra Project settings no canto superior direito da página do projeto ou Edit no menu de projetos. Clique em Save para aplicar as alterações.
  • Name and description: os nomes têm de 1 a 64 caracteres.
  • Repositories: o repositório principal não pode ser removido. Você pode puxar a versão mais recente do GitHub. Clique em Add repository e digite owner/name para clonar outro repositório junto com ele.
  • Base branch: as sessões criam branches de trabalho a partir deste branch, e os pushes e PRs têm este branch como destino.
  • Ship behavior: criar um PR (padrão), fazer push de um branch ou personalizado. Commit author pode ser AIHubMix Agent (padrão) ou sua conta do GitHub. Para commits e PRs, consulte Revisar e entregar resultados.

Gerenciar segredos e variáveis de ambiente

Adicione e edite-os em Settings › Workspace › Secrets & variables. Cada projeto tem seu próprio conjunto, além de um conjunto compartilhado por todos os projetos. Quando os nomes coincidem, o valor do projeto tem prioridade.
  • Os segredos são armazenados criptografados, e a IA não consegue ver os valores originais. Você também não consegue ver o valor original ao editar; digite um novo valor para substituí-lo.
  • Clique em Bulk add para colar diretamente o conteúdo de um .env, um KEY=value por linha. Nomes que contêm KEY, TOKEN, SECRET ou PASSWORD são salvos como segredos.
  • A exclusão não tem segunda confirmação. Ambientes em execução precisam ser reiniciados para que as alterações entrem em vigor.
  • Ao executar no seu dispositivo, as configurações do dispositivo controlam quais segredos do espaço de trabalho ficam disponíveis para esse computador. Consulte Executar no seu dispositivo.

Exportar um projeto

Nas configurações do projeto, clique em Export… e depois em Export. Quando o empacotamento terminar, clique em Download archive. O arquivo não inclui .env, segredos, dependências nem caches. O servidor na nuvem precisa estar em execução, e apenas o proprietário do projeto pode exportar.

Excluir um projeto

No menu de projetos ou nas configurações do projeto, clique em Delete project… e confirme. As sessões do projeto são arquivadas e podem ser restauradas em Settings › Workspace › Archived chats. Se houver alterações sem push, elas são listadas, e você precisa digitar o nome do projeto para excluí-lo.
A exclusão remove o ambiente na nuvem, os arquivos e os caches de dependências do projeto. Isso não pode ser desfeito. As pastas de projetos locais no seu computador não são afetadas.