Agendador Cron

O que faz

O Agendador Cron facilita criar e entender tarefas agendadas sem precisar decorar a

sintaxe críptica do cron. Você descreve em português ("toda segunda às 9h", "a cada 15

minutos em dias úteis", "no primeiro dia de cada mês") e o plugin gera a expressão cron

correta, valida, explica o que ela faz e ajuda a instalá-la no crontab do sistema ou

a registrá-la num arquivo de schedule do seu projeto.

A sintaxe * (minuto, hora, dia do mês, mês, dia da semana) é fonte de erros

clássicos — trocar dia da semana por dia do mês, esquecer fuso horário, criar uma

tarefa que roda a cada minuto sem querer. Este plugin atua como uma camada de tradução

e revisão para você agendar com confiança.

Casos de uso típicos:

• Agendar backups, sincronizações e limpezas recorrentes.
• Programar disparos de relatórios diários/semanais.
• Rodar scripts de manutenção em horários de baixo tráfego.
• Auditar um crontab existente para entender o que está agendado.

Instalação

1. Copie a pasta agendador-cron/ para o diretório de plugins do Claude Code.
2. Em sistemas Unix/Linux/macOS, o cron já costuma estar disponível

(crontab -l lista as tarefas).

1. (Opcional) Defina CRON_TIMEZONE para validar horários no fuso correto.
2. Reinicie o Claude Code.

Comandos disponíveis

• /cron-agendar — converte uma descrição em linguagem natural em expressão cron,

monta a linha completa do crontab e ajuda a instalá-la.

• /cron-explicar — recebe uma expressão cron (ou um crontab inteiro) e explica em

português quando cada tarefa roda, apontando riscos.

Configuração

Sempre por nome de variável de ambiente.

• CRON_TIMEZONE — fuso horário de referência (padrão: America/Sao_Paulo).

Lembre-se de que o cron usa o fuso do sistema; o plugin avisa quando há divergência.

• CRON_TARGET — onde registrar as tarefas: crontab (usuário atual) ou um arquivo

de schedule do projeto (ex.: ./schedule.cron). Padrão: mostra a linha e pede

confirmação antes de instalar.

• CRON_LOG_DIR — pasta para redirecionar logs das tarefas (recomendado para

depuração).

Nenhuma chave de API é necessária.

Exemplo de uso

/cron-agendar Rodar o script de backup todo dia útil às 2h da manhã.

O Claude gera 0 2 1-5, monta a linha completa

(0 2 1-5 /caminho/backup.sh >> ~/logs/backup.log 2>&1), explica o agendamento e

pergunta se deve instalar no crontab. Para auditar:

/cron-explicar */10 9-18 * * 1-5

Resposta: "A cada 10 minutos, das 9h às 18h, de segunda a sexta."

Segurança e limites

• Confirmação antes de instalar. O plugin sempre mostra a linha final e pede "ok"

antes de alterar seu crontab, evitando agendamentos acidentais.

• Cuidado com frequência alta. Tarefas a cada minuto podem sobrecarregar o sistema

ou estourar limites de serviços externos. O plugin alerta quando o intervalo é muito

curto.

• Fuso horário: o cron roda no fuso do servidor. O plugin sinaliza divergências

entre CRON_TIMEZONE e o fuso do sistema para você não agendar no horário errado.

• Logs sempre. Recomenda-se redirecionar saída e erros para um arquivo de log;

tarefas silenciosas que falham são difíceis de descobrir.

• Escopo: este plugin agenda e documenta; ele não monitora a execução. Para alertas

de falha, combine com slack-notificador.