Wakeclaude

wakeclaude

a tiny macos tui to schedule claude code prompts so your sessions can keep running even when you hit limits or go to sleep.

https://github.com/user-attachments/assets/d8d489d8-e676-47eb-a8bc-f54c677c0405

why i built it

i hit the 5 hour session rate limit on my claude plan a lot. work would stop mid‑flow, so i wanted a way to auto‑resume right when the limit resets.

now i can schedule a prompt to continue at the reset time, and i can also schedule prompts while i’m sleeping so the work keeps going. one thing i do weekly is run a security review on my codebases just before the weekly rate limit resets (while i’m asleep).

what it does

• pick a project, pick a session (or start a new one)
• write the prompt
• choose a model + permission mode
• schedule it (one‑time, daily, weekly)
• wakes your mac only when needed and runs the prompt
• keeps logs + shows a simple run history
• sends a native macos notification on success/error

install (homebrew)

brew install --cask rittikbasu/wakeclaude/wakeclaude

to update later:

brew update
brew upgrade --cask wakeclaude

quickstart

1. build it:

   go build -o wakeclaude ./cmd/wakeclaude

2. run it:

   ./wakeclaude

setup token (required)

wakeclaude uses a long‑lived claude code token so scheduled prompts keep working even after you close the terminal.

generate one in a separate terminal:

claude setup-token

paste it into wakeclaude when prompted. it stores the token in your **macos keychain** (not in files).

how it works (macos)

• uses launchd (launchdaemons) to run on schedule
• uses pmset schedule wakeorpoweron to wake the mac only when needed
• you’ll be prompted for sudo when creating/editing/deleting schedules
• the job runs as root, then uses launchctl asuser to run claude in your user session

important: if you are fully logged out, `claude` may not be able to access your keychain session. runni