Recursos do projeto
Anexe repositórios a um projeto para que os agentes saibam onde trabalhar e só façam checkout dos repositórios permitidos.
Recursos são os repositórios que um projeto usa. Eles dizem aos agentes onde fica o código daquele trabalho e limitam quais repositórios as execuções do projeto podem usar.
Anexar um repositório
No app, abra o projeto e, em Recursos, use Adicionar recurso. Escolha um dos repositórios do workspace ou cole a URL, por exemplo https://github.com/acme/loja ou git@github.com:acme/loja.git.
Pela CLI:
jiraya project resource add <project-id> --url git@github.com:acme/loja.gitTambém dá para anexar repositórios ao criar o projeto, repetindo --repo:
jiraya project create --title Loja --repo git@github.com:acme/loja.git --repo git@github.com:acme/api.gitBranch inicial
Cada repositório anexado pode ter uma Branch inicial. As novas execuções do projeto fazem checkout dessa branch e entregam o trabalho contra ela. Sem branch definida, vale a branch padrão do repositório. Mudar a branch não afeta o trabalho que já está em andamento.
jiraya project resource update <project-id> <resource-id> --ref release/2026-11A branch inicial precisa ser uma branch, não um commit, porque as execuções entregam o trabalho de volta nela. Para conferir um commit específico numa execução avulsa, o agente usa jiraya repo checkout <url> --ref <sha>.
O que o agente recebe
Quando um agente trabalha numa tarefa do projeto, ele recebe:
- a lista dos repositórios do projeto nas instruções da execução;
- o arquivo
.jiraya/project/resources.jsonno diretório de trabalho, com todos os recursos do projeto.
O agente busca o código com jiraya repo checkout <url>, que cria uma cópia de trabalho numa branch própria da execução, a partir de um cache local de clones mantido pelo daemon.
Checkout restrito aos repositórios do projeto
Quando o projeto tem ao menos um repositório anexado, as execuções das tarefas dele só podem fazer checkout desses repositórios. Um jiraya repo checkout de outro endereço é recusado, e a mensagem lista os repositórios permitidos.
| Situação | Repositórios disponíveis para o checkout |
|---|---|
| Tarefa num projeto com repositórios anexados | Só os repositórios do projeto. |
| Tarefa num projeto sem repositórios | Os repositórios do workspace. |
| Tarefa sem projeto | Os repositórios do workspace. |
Atenção
Se o daemon não conseguir confirmar a lista de repositórios do projeto, por exemplo por uma falha de rede, o checkout é recusado até a próxima tentativa. Ele nunca libera um repositório que não pôde verificar.
Comandos da CLI
| Comando | O que faz |
|---|---|
jiraya project resource list <project-id> | Lista os recursos do projeto. |
jiraya project resource add <project-id> --url <url> | Anexa um repositório. Aceita --ref (branch inicial) e --label. |
jiraya project resource update <project-id> <resource-id> | Altera a URL, a branch inicial, o rótulo ou a posição. |
jiraya project resource remove <project-id> <resource-id> | Remove o recurso do projeto. |
Atualizado em