PromptPilot: um agendador de tarefas para Claude Code e Codex que trabalha enquanto você dorme

Cotas de tokens, limites de requisições e janelas de reinício são ditados pelo provedor, não pelo desenvolvedor. Mas sobra um recurso sob controle do desenvolvedor: o momento de enviar a tarefa. É disso que o PromptPilot cuida. Ele é um agendador de fila de prompts para ferramentas CLI de IA que permite disparar um agente de código antecipadamente, sem você estar diante do monitor.

O que é o PromptPilot e para que serve

O PromptPilot é uma ferramenta de código aberto que um desenvolvedor escreveu para si mesmo, mas publicou na expectativa de que ele não seja o único com esse problema. O cenário é simples: você quer iniciar uma tarefa no Claude Code ou no Codex à uma da manhã, quando o provedor zera o limite, mas a essa hora já está dormindo. Ou o contrário: de manhã você abre o notebook e quer que o aquecimento da sessão já tenha acontecido sem você.

O sistema aceita tarefas por três interfaces: um terminal comum, uma interface web e um bot do Telegram. Um worker pega as tarefas da fila e as executa em sequência. Se a ferramenta esbarra em um rate limit, ela não quebra: faz uma pausa e tenta de novo automaticamente. Isso é especialmente útil para quem usa planos gratuitos ou limitados, em que cada reinício de limite exige uma nova execução manual.

Arquitetura: SQLite e três processos

A parte técnica é minimalista de propósito. A fila inteira fica em SQLite, sem brokers externos como Redis ou RabbitMQ. Três processos (servidor de API, worker e bot do Telegram) se comunicam pelo banco de dados. Isso permite rodar tudo em um notebook comum ou em uma VPS barata, sem infraestrutura complexa.

As tarefas têm prioridades e horário de início. É possível agendar uma tarefa com a marcação «executar às 03:00», e o worker a pega no momento certo. O projeto suporta Claude Code, Codex e Qwen, na prática qualquer ferramenta CLI que aceite prompts pela entrada padrão. Tarefas de maior prioridade são executadas antes das demais, mesmo que tenham entrado na fila depois.

O bot do Telegram como controle remoto

Outro cenário é a interação com o modelo pelo bot. Se o agente de IA fizer uma pergunta de esclarecimento no meio da tarefa, o usuário recebe uma notificação no Telegram e pode responder ali mesmo, sem abrir o terminal. Isso é crucial se a tarefa foi enviada antes de sair de casa ou se o agente travou esperando uma resposta enquanto você dormia.

O bot não só mostra o status da tarefa: ele funciona como um canal completo de comunicação bidirecional com o modelo. Para quem trabalha muito em movimento ou pelo celular, é um detalhe importante: você não perde o controle do agente, mesmo estando fisicamente longe do computador.

Por que isso importa

O PromptPilot não é um produto de uma grande empresa nem um SaaS com assinatura paga. É uma ferramenta feita para uma dor específica: o descompasso entre o horário de trabalho do desenvolvedor e o calendário de limites dos provedores. O autor admite que fez o projeto para si, mas é justamente por isso que ele resolve um problema real, não inventado.

À medida que as ferramentas CLI de IA se tornam parte padrão do fluxo de trabalho, a necessidade de gerenciar o fluxo de tarefas e os limites só vai crescer. O PromptPilot preenche essa lacuna com meios simples: sem Kubernetes, sem filas de mensagens, sem deploy complicado. Um SQLite, três processos e um bot do Telegram, e seu agente de IA trabalha no horário agendado.

O código do projeto está publicado, e a implantação está descrita no README. É um caso em que o código aberto resolve justamente o problema que as ferramentas comerciais ignoram, por ser pequeno demais para justificar um produto próprio.