Ir para o conteúdo
Promovaweb
Projeto open source da Promovaweb

Cronboard no SetupVibe

Tarefas agendadas no terminal

O crontab com aliases curtos e um painel para ver, pausar e editar cada tarefa.

Todo dia, à meia-noite
  1. 0minuto0 a 59
  2. 0hora0 a 23
  3. *dia do mês1 a 31
  4. *mês1 a 12
  5. *dia da semana0 a 6

df -h > $HOME/cron-disk-usage.log

O crontab em poucas teclas

Quatro aliases cobrem o crontab do seu usuário. O Cronboard mostra as mesmas tarefas numa interface de terminal.

cronlcrontab -l

Lista de tarefas

No Desktop e no Server, você usa cronl para executar crontab -l. Esse é o alias definido para consultar as tarefas do seu usuário.

cronecrontab -e

Criar ou editar uma tarefa

O alias crone executa crontab -e no Desktop e no Server. Você pode revisar as entradas pelo editor configurado para esse comando.

cronbcronboard

Abrir o Cronboard

Você usa cronboard no Desktop ou na Omarchy. O alias cronb existe nos arquivos Zsh do Desktop. A camada Omarchy não cria esse alias.

Ver o projeto Cronboard

cronrcrontab -r

Remoção pelo alias cronr

No Desktop e no Server, cronr executa crontab -r. Você deve revisar o comando antes de usá-lo, pois ele remove as tarefas do crontab.

Cuidado com crontab -r

A definição de cronr não inclui uma confirmação adicional do SetupVibe. Você pode consultar primeiro cronl e preservar as entradas antes de usar o alias de remoção.

O Cronboard por dentro

O Cronboard lista as tarefas do crontab, descreve cada expressão em linguagem natural e valida a expressão enquanto você digita. Tudo pelo teclado.

Teclas dentro do Cronboard
TeclaO que faz
jkNavega entre as tarefas (as setas também funcionam)
nCria uma tarefa
eEdita a tarefa selecionada
pPausa ou retoma a tarefa, comentando a linha no crontab
dExclui a tarefa
sSalva as alterações
fFiltra as tarefas
qSai do Cronboard

Exemplos de agendamento

No Desktop, você recebe duas entradas de exemplo no crontab: um heartbeat horário e um relatório diário de disco. O script consulta as entradas existentes antes de acrescentar esses exemplos.

Vem com o Desktop

Exemplo horário do instalador

Toda hora, no minuto 0

O Desktop acrescenta esta entrada para o heartbeat horário:

0 * * * * echo "Cron heartbeat: $(date)" >> /tmp/cron-heartbeat.log
Vem com o Desktop

Exemplo diário do instalador

Todo dia, à meia-noite

O segundo exemplo do Desktop grava o uso de disco no arquivo do seu usuário:

0 0 * * * df -h > $HOME/cron-disk-usage.log

Mais exemplos para adaptar

Troque os caminhos e os endereços pelos seus antes de colar no crone. O cron roda com um PATH curto, então use caminhos completos nos seus scripts.

  • */5 * * * *A cada 5 minutoscurl -fsS https://seu-app.dev/health > /dev/null
  • 30 2 * * *Todo dia, às 2h30$HOME/scripts/backup.sh >> $HOME/backup.log 2>&1
  • 0 9 * * 1-5De segunda a sexta, às 9hcd $HOME/projetos/api && git pull --ff-only
  • 0 3 * * 0Todo domingo, às 3hdocker system prune -f
  • 0 8 1 * *Dia 1 de cada mês, às 8h$HOME/scripts/relatorio-mensal.sh
  • @rebootSempre que a máquina liga$HOME/scripts/ao-ligar.sh

Expressões gravadas pelo Desktop

Você pode revisar as duas expressões que o Desktop grava: 0 * * * * no heartbeat e 0 0 * * * no relatório de disco. Esses são os exemplos incluídos pelo instalador.

Arquivos dos exemplos cron

O exemplo horário grava /tmp/cron-heartbeat.log. O exemplo diário grava ~/cron-disk-usage.log. Você pode conferir esses caminhos após a execução das tarefas. O SetupVibe não configura notificações Telegram para o Cronboard.

Conferência das entradas existentes

O Desktop consulta crontab -l e procura os caminhos dos dois arquivos de exemplo antes de acrescentar as entradas. Assim, você não recebe outra entrada desses exemplos apenas por executar essa rotina novamente.

Preservação das entradas anteriores

O Desktop lê as entradas atuais com crontab -l, acrescenta os exemplos ausentes e grava o resultado com crontab -. Você mantém as entradas anteriores nessa rotina.

Usuário do crontab

O Desktop usa user_do para consultar e gravar o crontab do usuário-alvo. Você deve conferir qual usuário recebeu a instalação, principalmente ao iniciar o script com sudo.

Cronboard em cada edição

Desktop e Omarchy instalam Cronboard: Homebrew no macOS Desktop e uv no Linux Desktop e na Omarchy. O Server instala cron e os aliases do crontab, sem Cronboard. A edição Windows não instala cron ou Cronboard.

Cronboard numa VPS de desenvolvimento

Para uma VPS de desenvolvimento, Vibe Coding ou agentes remotos, você usa a edição Desktop. A edição Server atende máquinas que executam aplicações em produção.

O instalador não configura conexões remotas do Cronboard. Ele instala o programa no ambiente local da edição escolhida.

Requisitos

No macOS Desktop, o Cronboard usa Homebrew. No Linux Desktop e na Omarchy, o comando de instalação usa uv tool install git+https://github.com/antoniorodr/cronboard. O SetupVibe não fixa uma versão do Cronboard nem declara um número mínimo de Python para ele.