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

Quotas de tokens, limites de requisições, janelas de reset — tudo ditado pelo provedor, não pelo desenvolvedor. Mas o desenvolvedor mantém um recurso sob controle pessoal: o momento do envio da tarefa. Exatamente isso é o que faz o PromptPilot — um agendador de fila de prompts para ferramentas CLI de IA que permite lançar um agente de código sem estar monitorando.

O que é PromptPilot e por que é necessário?

PromptPilot é uma ferramenta open-source escrita por um desenvolvedor para si mesmo, mas publicada na suposição de que a situação é familiar para mais pessoas. O cenário é simples: você quer executar uma tarefa no Claude Code ou Codex à meia-noite — quando o provedor reseta o limite — mas você já está dormindo. Ou inversamente: pela manhã você abre o notebook e quer que o aquecimento da sessão já tenha acontecido sem você.

O sistema aceita tarefas de três interfaces: terminal comum, interface web e bot do Telegram. Um worker coleta as tarefas da fila e as executa sequencialmente. Se a ferramenta encontra um rate limit — ela não falha, mas faz uma pausa e tenta novamente automaticamente. Isso é especialmente relevante para quem trabalha com planos gratuitos ou limitados, onde cada reset de limite requer reinicialização manual.

Arquitetura: SQLite e três processos

A implementação técnica é intencionalmente minimalista. Toda a fila é armazenada em SQLite — sem brokers externos como Redis ou RabbitMQ. Três processos: servidor API, worker e bot do Telegram — comunicam-se através do banco de dados. Isso permite executar tudo em um notebook comum ou VPS econômico sem infraestrutura complexa.

As tarefas têm prioridades e horários de execução. Você pode definir uma tarefa com a marcação "executar às 03:00" — o worker a pegará no momento certo. São suportados Claude Code, Codex e Qwen — basicamente qualquer ferramenta CLI que aceita prompts da entrada padrão. Tarefas com prioridade mais alta serão executadas antes das outras, mesmo que enfileiradas depois.

Bot do Telegram como painel de controle

Um cenário separado — interação interativa com o modelo através do bot. Se o agente de IA faz 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 é crítico se a tarefa foi submetida antes de sair de casa ou o agente ficou preso esperando entrada enquanto você dormia.

O bot não apenas mostra o status da tarefa, mas funciona como um canal de comunicação bidirecional completo com o modelo. Para quem trabalha frequentemente em movimento ou do celular, esse é um detalhe significativo: você não perde controle do agente mesmo estando fisicamente longe do computador.

Por que isso importa

PromptPilot não é um produto de uma grande empresa nem um SaaS com assinatura paga. É uma ferramenta construída para uma dor específica: o desajuste entre o cronograma de trabalho do desenvolvedor e o cronograma de limite de taxa do provedor. O autor reconhece que o projeto foi feito para si mesmo — mas é exatamente por isso que resolve um problema real, não inventado.

À medida que ferramentas de CLI de IA se tornam parte padrão do fluxo de trabalho, a necessidade de gerenciar fluxo de tarefas e limites só crescerá. PromptPilot fecha essa lacuna com meios simples — sem Kubernetes, sem filas de mensagens, sem deployment complexo. Um SQLite, três processos, um bot do Telegram — e seu agente de IA funciona em cronograma. O código do projeto é publicado, o deployment é descrito no README. Este é um caso em que o open-source resolve exatamente o problema que ferramentas comerciais não notam — porque é muito pequeno para construir um produto separado em torno dele.