Fresh – Agendador de Prompts por Reset de Quota
lucasyhzhu-debug/fresh
Executa prompts pesados no reset exato de sua quota de 5 horas
Ver no GitHubSkill para Claude Code que dispara automaticamente um prompt no exato momento em que sua janela de uso de 5 horas é resetada, garantindo quota plena. Detecta o próximo reset via ccusage e escalona a execução com margem de segurança, funcionando em modo de injeção de contexto ou sessão headless isolada.
Instalação
npx convez-ai lucasyhzhu-debug/fresh1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agendar execuções longas (e2e tests, migrações) para começar com quota cheia
- Automatizar workflows plan-then-execute com disparo no reset
- Evitar desperdício de quota agendando no final de janelas parciais
Veredito

Ferramenta especializada e bem pensada para contornar limite de uso do Claude via agendamento inteligente. Implementação sólida com fallbacks (--at manual), mas requer máquina acordada e tem suporte principal apenas em Windows; recomendado para quem roda workloads pesadas regularmente.
README
A tradução para o português deste README ainda está na fila.
fresh
A Claude Code skill that fires a prompt exactly when your next 5-hour usage window resets — so your biggest runs start with a full tank.
/fresh <prompt text | path/to/prompt.md> [--clear] [--at HH:MM] [--now]
Why
Claude usage limits work in 5-hour blocks. Kick off a heavy run 20 minutes before a reset and you burn the stub of the old window, hit the limit, and stall. fresh detects the next reset (via ccusage) and schedules your prompt for reset + 2 minutes — the +2 matters, because one-shot crons can fire up to 90 seconds early and land your run in the old, exhausted window.
Two modes:
| Mode | What happens | Needs |
|---|---|---|
| default | One-shot cron injects the prompt into your current session — context preserved | Session left open |
--clear | Task Scheduler launches a brand-new headless claude -p session — fresh context and fresh quota | Machine awake |
Pairs well with plan-then-execute workflows: queue your handoff file (/fresh .claude/handoff/execute-my-plan.md --clear) and the execution starts the moment a full window opens.
Install
npx skills add lucasyhzhu-debug/fresh
or manually:
git clone https://github.com/lucasyhzhu-debug/fresh ~/.claude/skills/fresh
Usage
/fresh "run the full e2e suite and fix what breaks"
/fresh .claude/handoff/execute_v0-8.md --clear
/fresh "resume the migration" --at 14:00
/fresh "continue" --now
- A file argument schedules
Execute the instructions in <path>— the file is read at fire time, not queue time. --at HH:MMoverrides detection (local time).--nowruns immediately (useful when no block is active — there's no "next reset" to wait for).
Notes & caveats
- Windows-first.
--clearmode usesschtasks; on macOS/Linux the skill says to useat/launchdinstead, but that path is less travelled. - Headless runs default to
--permission-mode acceptEdits; unattended Bash/git needs--dangerously-skip-permissions, which is your call to make. - Reset detection shells out to
npx ccusage@latest; offline, fall back to--at(your reset time is shown by/usage). - Scheduled tasks self-delete after firing; logs land in
tmp/fresh-run-<id>.log, resumable withclaude --resume.
License
MIT © Lucas Zhu