convez.ai
SkillAutomaçãoIntermediário
lucasyhzhu-debug

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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/fresh

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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:

ModeWhat happensNeeds
defaultOne-shot cron injects the prompt into your current session — context preservedSession left open
--clearTask Scheduler launches a brand-new headless claude -p session — fresh context and fresh quotaMachine 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:MM overrides detection (local time).
  • --now runs immediately (useful when no block is active — there's no "next reset" to wait for).

Notes & caveats

  • Windows-first. --clear mode uses schtasks; on macOS/Linux the skill says to use at/launchd instead, 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 with claude --resume.

License

MIT © Lucas Zhu

Part of Lucas's open-source Claude Code skills.

Ver o original no GitHub

Bom para

Relacionados