Desenvolvedor cria gerenciador de tarefas em que o Claude Code pega trabalhos agendados por conta própria

Uma situação conhecida: o agente é ótimo para redigir um e-mail ou comparar bibliotecas, mas sempre precisa receber uma explicação exata do que deve fazer. Você abre o chat, formula a tarefa, espera e copia o resultado. O autor do projeto concluiu que já tinha um lugar onde todas as demandas ficavam: sua lista de tarefas. Faltava apenas ensinar os agentes a buscá-las por conta própria.

Como funciona

No gerenciador shar8.app, qualquer tarefa pode receber a marca “Para o agente”. Somente uma pessoa pode ativá-la no aplicativo, portanto o agente não consegue atribuir trabalho a si mesmo. Em seguida, se o computador estiver ligado, o agente pega em até um minuto uma tarefa prevista para hoje ou atrasada, executa-a e registra o resultado nas anotações. A tarefa recebe um destes status: “Em revisão”, “É preciso esclarecer” ou “O agente falhou”. Uma pessoa a encerra depois de ler o relatório.

A integração usa MCP sobre HTTP. Há um único endereço, e qualquer cliente compatível com servidores MCP remotos pode se conectar sem um plugin específico. Claude Code, Codex CLI e OpenCode trabalham com a mesma lista. O servidor oferece 15 ferramentas para leitura, criação e edição, além de três ferramentas de serviço para delegação: agent_queue, agent_claim e agent_finish. As três últimas só são chamadas pelo agente executado conforme uma programação.

Durante uma conversa, isso parece natural. No meio do trabalho com o código, você pode dizer: “Adicione uma tarefa: atualizar as dependências na sexta-feira”, e a tarefa aparecerá no celular.

Um plugin para Claude Code cuida da execução sem participação humana. Ele adiciona um trabalho ao agendador do sistema: launchd no Mac, um timer do systemd no Linux ou o Agendador de Tarefas no Windows. Uma vez por minuto, o plugin verifica a fila. Se ela estiver vazia, o modelo nem sequer é chamado. Cada execução pega no máximo três tarefas e reserva 15 minutos para cada uma. Se o servidor estiver indisponível, o plugin aumenta o intervalo em vez de continuar tentando a cada minuto. O modelo é executado em sua máquina com sua assinatura ou seu ANTHROPIC_API_KEY, e o servidor não vê suas chaves.

Dois detalhes merecem ser reaproveitados. Uma tarefa fica sob controle de exatamente uma execução, impedindo que outra a pegue. Além disso, uma tarefa travada retorna automaticamente com o status “O agente falhou”, em vez de permanecer em andamento para sempre.

Segurança: o que existe e o que não existe

O texto da tarefa é tratado como entrada não confiável. Se alguém colar nela um e-mail de terceiros, ele poderá conter instruções para o modelo. Por isso, o agente é informado de que o conteúdo consiste em dados, não em comandos. Além disso, por padrão ele não tem ferramenta alguma: vê texto e responde com texto. A busca na internet é ativada por um arquivo de configuração separado. O envio para fora fica desativado e só pode ser habilitado por meio de uma lista explícita de destinatários permitidos.

O autor explica com franqueza o que falta. Um agente conectado durante uma conversa vê todas as tarefas e pode excluí-las; ainda não é possível restringir suas permissões. Ele não considera um prompt uma barreira de segurança: a proteção vem da ausência de ferramentas e da revisão humana. Para a operação sem supervisão, recomenda limitar as ferramentas no lado do cliente.

Há dois tipos de autorização. Somente Claude Code e Codex podem se conectar pelo navegador usando OAuth; os demais clientes recebem um erro na tela de consentimento. Para cron, claude -p e OpenCode, é emitido um token pessoal exibido uma única vez. A revogação entra em vigor imediatamente, sem esperar o fim da validade.

Veja o que foi testado em sistemas reais e o que não foi: um Mac com o cliente claude real e uma assinatura funciona, e a tarefa foi pega em um minuto. O Linux está coberto por testes, mas não foi executado em uma máquina real. O Windows está em beta. A chamada tasks_list pelo Codex não foi testada; somente a autenticação foi verificada.

O que aproveitar desse projeto

O serviço em si é de nicho, mas o padrão é universal. Uma fila para agentes se apoia em três elementos: captura exclusiva da tarefa, recuperação automática de tarefas travadas e revogação imediata do acesso. O resultado do agente deve chegar com o status “em revisão”, não “concluído”. E quanto menos permissões tiver um agente que trabalha durante a noite, melhor: é mais fácil conceder novos acessos do que descobrir onde uma tarefa foi parar.