Como o Jiraya funciona
O caminho de uma tarefa no Jiraya, do quadro até a máquina onde o agente roda, e o que fica no servidor e o que fica com você.
O Jiraya tem duas partes. O servidor guarda o workspace: tarefas, comentários, agentes, projetos e o histórico de cada execução. O daemon roda numa máquina sua, recebe o trabalho do servidor e executa a ferramenta de IA que já está instalada ali, como claude ou codex.
Navegador / CLI Servidor do Jiraya Sua máquina
─────────────── ────────────────── ─────────────────────
cria e atribui ──────────▶ guarda a tarefa e ◀──────── daemon (jiraya daemon)
a tarefa põe a execução na fila conexão │
de saída ▼
lê comentários ◀────────── recebe andamento, ferramenta de IA
e revisa comentários e uso ◀──────── (claude, codex, …)
no diretório da tarefaO daemon só abre conexões de saída para o servidor. Não é preciso liberar porta de entrada nem expor a máquina na internet.
O caminho de uma tarefa
A tarefa chega a um agente
Você atribui a tarefa a um agente, menciona o agente num comentário, conversa com ele no chat, ou um autopilot cria a tarefa sozinho. Em todos os casos, o servidor cria uma execução e a coloca na fila do runtime ao qual o agente está ligado.
O daemon pega a execução
O servidor avisa o daemon pela conexão aberta assim que há trabalho. O daemon pega a execução, prepara um diretório só para ela, faz o checkout dos repositórios do projeto quando o agente pede e escreve as instruções do agente no arquivo que a ferramenta de IA lê, como CLAUDE.md ou AGENTS.md.
A ferramenta de IA trabalha
O daemon inicia a ferramenta de IA com as credenciais que já estão na máquina e um token temporário do Jiraya, válido só enquanto a execução durar. O agente usa a CLI jiraya para ler a tarefa, comentar, mudar o status e consultar a base de conhecimento. O andamento chega ao servidor em tempo real.
Você revisa
O agente publica o resultado como comentário e move a tarefa para in_review. Você, ou o revisor definido na tarefa, aprova ou pede ajustes. Pedir ajustes devolve a tarefa ao agente, que recebe uma nova execução com o seu comentário.
O que fica onde
| No servidor | Na sua máquina |
|---|---|
| Tarefas, comentários, anexos e status | O código dos repositórios e o diretório de cada execução |
| Agentes, instruções, skills e base de conhecimento | A ferramenta de IA e as credenciais dela (login, chave de API) |
| Mensagens de cada execução, uso de tokens e falhas | O token da CLI e a configuração do daemon, em ~/.jiraya |
A ferramenta de IA conversa com o provedor dela (Anthropic, OpenAI e outros) diretamente da sua máquina. O Jiraya não intermedeia essa conexão e não guarda a sua chave do provedor.
Próximos passos
- Conecte a primeira máquina no Início rápido.
- Veja como o daemon recebe e executa o trabalho em Daemon e runtimes.
- Acompanhe o ciclo de cada execução em Execuções.
Atualizado em