claude-code-ping-start-5h-quota

Schedules a one-time macOS timer that pings Claude CLI after quota reset to start the 5-hour usage window.

1.4k|216|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daymade/claude-code-skills --skill claude-code-ping-start-5h-quota
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-ping-start-5h-quota
Source: https://github.com/daymade/claude-code-skills/tree/main/daymade-claude-code/claude-code-ping-start-5h-quota
Command: npx skills add https://github.com/daymade/claude-code-skills --skill claude-code-ping-start-5h-quota

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude subscription usage windows only start counting when the first request is sent, so after quota exhaustion the new 5-hour window sits idle until someone sends a message. This Skill sets a one-time local timer that automatically sends a minimal claude -p ping right after the quota resets, so the new window starts (and partially elapses) while the user sleeps.

Core Features & Use Cases

  • One-time background timer: Uses caffeinate -is plus sleep via a detached background process to fire a single claude -p "Reply with exactly: ok" request at the computed reset time plus a 5-minute buffer.
  • Time calculation and verification: Converts relative or absolute reset times into wait minutes, reports the exact wall-clock trigger time, and independently verifies the process chain with ps.
  • Wake-up confirmation and recovery: When the timer exits, the session is re-woken to read the task output file, confirm the ok response, and report the actual trigger time from the file's modification timestamp.
  • Use Case: Before going to bed with quota exhausted and a reset in 1 hour 20 minutes, ask the assistant to schedule a ping; the timer fires at the reset time, and by morning the new 5-hour window has already been running for hours.

Quick Start

Tell the assistant: my Claude quota resets in 1 hour and 20 minutes, set a one-time timer to ping Claude after it resets so the new 5-hour window starts while I sleep.

Frequently Asked Questions about claude-code-ping-start-5h-quota

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule a one-time ping to Claude after my quota resets?

Tell the assistant your reset time, and it computes the wait minutes plus a 5-minute buffer, then launches a background process running caffeinate, sleep, and claude -p. The ping fires automatically at the target wall-clock time without further input.

How does the Claude 5-hour usage window actually start?

The 5-hour window starts counting from the first request sent within it, not at a fixed clock time. Sending one minimal claude -p message right after reset starts the window immediately, so much of it elapses while you sleep.

Does this quota ping timer work on Linux or Windows?

No, it only supports macOS because it relies on caffeinate and the BSD date -v flag. Linux equivalents like systemd-inhibit and date -d are unverified, and the Skill explicitly declines to improvise ports to other platforms.

What happens if my Mac sleeps or the lid closes before the timer fires?

caffeinate -is prevents idle and system sleep while plugged in, but it cannot stop a physical lid close or shutdown. If the machine sleeps, the sleep timer pauses and the ping fires late after wake, which is detectable via the output file's modification time.

Can I use this for recurring daily pings instead of a one-time timer?

No, this Skill is strictly for one-time timers. For recurring or daily scheduling it directs you to /loop, system cron, or launchd instead of chaining one-off sleep processes.

How do I cancel the scheduled ping if I change my mind?

Cancel by running pkill -f 'Reply with exactly: ok', which matches the command signature and kills the caffeinate and shell processes. Killing by the sleep seconds value is forbidden because unrelated long-running scripts may share the same interval.