claude-nextsessionlisted

# claude-nextsession Skill ## Purpose Postpone a series of instructions to the moment your Claude Code usage session resets. The skill: 1. **Reads the local rate-limit cache** to get the exact reset time for the current 5-hour usage window. 2. Schedules a script to run at that exact time with the provided instructions, invoking `claude -p` non-interactively. ## How It Works Claude Code's statusline hook (`~/.claude/statusline-command.sh`) already receives a `rate_limits` JSON object from Claude Code on every turn — the same data behind the `session 42% (60m)` indicator in the status bar. This skill piggybacks on that: the statusline script now also writes the raw `rate_limits` object to `~/.claude/cache/rate-limits.json` each time it renders. `postpone.py` reads `rate_limits.five_hour.resets_at` from that cache — no API call, no API key needed. This only works for Claude Code's own subscription-based session limits; it has nothing to do with pay-per-token API rate limits (those are a different quota system and aren't relevant here). **Prerequisite**: the cache must be fresh. It's written on every turn of an active Claude Code session, so just having run a prompt recently in this (or any) session is enough. If the cache is missing or older than 6 hours, the script refuses to guess and asks you to run a prompt first. ## Permissions (important) The scheduled task runs headless via `systemd-run` — nobody is there to answer a permission prompt. Without an explicit per