Daemon e runtimes

O daemon é o processo da CLI jiraya que roda em segundo plano na sua máquina. Ao iniciar, ele procura as ferramentas de IA instaladas e registra cada uma como um runtime no workspace. Na interface, os runtimes ficam na página Ambientes de execução.

Um daemon com claude e codex instalados, servindo um workspace, aparece como dois runtimes: um para cada ferramenta. Cada agente é ligado a um runtime, e é nele que as execuções desse agente rodam.

Iniciar e pararCopiar link da seção

O jeito mais simples é o setup, que faz login, inicia o daemon e registra a máquina num workspace:

$jiraya setup --workspace acme

Depois disso, controle o daemon com:

Para servir outro workspace na mesma máquina, rode o setup de novo com o outro --workspace. Os dois continuam sendo servidos, cada um com o próprio registro.

Como o trabalho chegaCopiar link da seção

1. O daemon mantém uma conexão de saída com o servidor e envia um sinal de vida a cada 15 segundos.
2. Quando há uma execução para um dos seus runtimes, o servidor avisa pela conexão, e o daemon a pega na hora. A cada 30 segundos o daemon também confere a fila, para o caso de um aviso se perder.
3. O daemon cria um diretório só para a execução, inicia a ferramenta de IA e envia o andamento ao servidor.

Na página Ambientes de execução, o runtime aparece como Conectado quando o servidor recebeu sinal nos últimos 45 segundos, Perdido recentemente até 5 minutos sem sinal, e Desconectado depois disso.

Por padrão, um daemon roda até 20 execuções ao mesmo tempo, somando todos os workspaces. As demais esperam na fila.

Ambientes privados e públicosCopiar link da seção

Um runtime nasce privado: só quem o registrou pode criar agentes nele. Na página Ambientes de execução, o dono pode usar Tornar público no espaço de trabalho, e qualquer membro passa a poder criar agentes nesse runtime. A visibilidade vale por workspace e só o dono pode mudá-la.

Acompanhar o daemonCopiar link da seção

$jiraya daemon logs -f

O comando mostra antes o caminho do arquivo de log que está lendo. Outros comandos úteis:

• jiraya daemon watch abre um painel no terminal com as execuções, os eventos e as chamadas de ferramenta, ao vivo. Use Tab para trocar de visão e q para sair.
• jiraya daemon disk-usage mostra quanto disco cada execução ocupa e quanto pode ser limpo.
• jiraya runtime list lista os runtimes do workspace, de todas as máquinas.

Iniciar junto com o sistemaCopiar link da seção

$jiraya daemon autostart enable

O comando registra o daemon no mecanismo do sistema, sem precisar de administrador:

jiraya daemon autostart status mostra se a entrada está ativa e aponta problemas, como um executável que mudou de lugar. disable remove a entrada, sem parar o daemon que já está rodando.

O enable guarda o PATH do seu terminal, para o daemon encontrar as ferramentas de IA. Outras variáveis JIRAYA_* exportadas só no terminal não são levadas para a entrada: grave-as com jiraya config set.

PerfisCopiar link da seção

Um perfil isola configuração, login, daemon e diretórios. Use quando precisar de dois daemons na mesma máquina, por exemplo com contas diferentes:

$jiraya daemon start --profile outra-conta

Sem --profile, os arquivos ficam em ~/.jiraya/. Com perfil, em ~/.jiraya/profiles/<nome>/. Passe o mesmo --profile para status, logs e os demais comandos do daemon.

Diretórios de trabalho e limpezaCopiar link da seção

Cada execução trabalha em ~/jiraya_workspaces/<workspace>/…, com permissão só para o seu usuário. Os repositórios são clonados uma vez em .repos e cada tarefa recebe uma worktree própria.

O daemon limpa esses diretórios a cada 30 minutos:

• Tarefa concluída ou cancelada: o diretório é apagado depois de 10 minutos sem atividade.
• Tarefa ainda aberta: depois de 12 horas da última execução, só as pastas regeneráveis (node_modules, .next, .turbo) são apagadas. O diretório inteiro sai 14 dias depois da última execução.
• Diretórios sem dono, de um daemon que caiu: apagados depois de 72 horas.
• Clones em .repos: apagados 30 dias depois do último uso, quando o repositório não está mais ligado a nenhum workspace servido.

Um diretório com alterações não commitadas ou commits não enviados é mantido. Uma tarefa ativa nunca é apagada.

ConfiguraçãoCopiar link da seção

As opções mais usadas, por flag do jiraya daemon start ou variável de ambiente:

Para cada ferramenta de IA há também JIRAYA_<FERRAMENTA>_PATH, com o caminho do executável, e JIRAYA_<FERRAMENTA>_MODEL, com o modelo padrão. Veja a lista em Comparativo das ferramentas. Todas as flags estão na referência de jiraya daemon.

AtualizaçõesCopiar link da seção

O daemon atualiza a CLI sozinho quando sai uma versão nova, esperando as execuções em andamento terminarem. Para atualizar na hora, rode jiraya update, ou use o botão Atualizar do runtime na página Ambientes de execução. Quando uma ferramenta de IA é atualizada, o daemon detecta a nova versão sem reiniciar.

Ambientes personalizadosCopiar link da seção

Se você usa uma ferramenta compatível com uma das suportadas, mas com outro comando (um wrapper, um fork, argumentos fixos), crie um ambiente personalizado: em Ambientes de execução, Adicionar ambiente personalizado, escolha o ambiente base e informe o comando. Pela CLI, use jiraya runtime profile create. Os daemons que encontram esse comando no PATH passam a registrá-lo como runtime.