gitwtfhub

wtf is claude-wake?

kazuki-sf/claude-wake — explained in plain English

Analysis updated 2026-05-18

2JavaScriptAudience · developerComplexity · 2/5Setup · easy

TL;DR

A CLI and menu bar app that auto-resumes a stalled Claude Code VS Code session the moment your usage limit resets.

Mindmap

mindmap
  root((claude-wake))
    What it does
      Detects usage limit resets
      Refocuses the panel
      Pastes resume message
    Tech stack
      Node.js CLI
      Tauri menu bar app
    Use cases
      Overnight session resume
      Login watcher
      Countdown dashboard
    Audience
      Claude Code users
    Platforms
      macOS Accessibility

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Auto-resume an overnight Claude Code session the moment the usage limit resets.

REASON 2

Run a menu bar app showing a live countdown to the next auto-resume.

REASON 3

Use the CLI to check daemon status and scheduled resumes as JSON.

REASON 4

Customize the resume message that gets pasted into the stopped panel.

What's in the stack?

JavaScriptNode.jsTauriRust

How it stacks up

kazuki-sf/claude-wake3imed-jaberi/cryptography-si-isamm3imed-jaberi/koa-isomorphic-router
Stars222
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-09-252021-02-06
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

macOS Accessibility permission is required for pasting into the VS Code panel.

Wtf does this do

claude-wake solves a specific annoyance for people using Claude Code inside VS Code: when a usage limit stops a session overnight, nobody is around to type continue once the limit resets, so hours of working time are lost. claude-wake watches for that reset, brings the exact stopped panel back to the front, and automatically sends a resume message, so the work picks back up while the user is away or asleep. It runs two ways that share the same underlying engine and state: a zero dependency command line tool built for Node 18 or newer, and an optional menu bar app built with Tauri, which combines Rust with plain HTML rather than a full web frontend. Both can be installed from npm or built from source, and only one of the two should run at a time since they share the same state folder. Under the hood, claude-wake works in three steps. It detects a usage limit by tailing Claude Code's own session transcript files, which record the reset time along with a timezone, without doing any screen scraping. At reset time it uses a VS Code deep link to bring the exact panel back into focus, even if many panels are open. Since the panel's input ignores fake keystrokes but accepts a paste, claude-wake puts the resume message on the clipboard and performs a paste plus Enter, only after confirming the editor window is in front. It fires once per limit, skips a session that was already resumed manually, and its default message is written to be harmless even if it triggers when it was not actually needed. On macOS, sending a paste requires Accessibility permission, which claude-wake requests only for a small dedicated helper app it compiles locally, rather than for the terminal or Node itself. The menu bar app adds a popover with a live countdown to the next resume, the ability to edit the resume message, and pause and resume controls, while the CLI exposes commands like watch, install, status, pause, resume, doctor, test, and logs.

Yoink these prompts

Prompt 1
Set up claude-wake for me so it auto-resumes my Claude Code VS Code panel when my usage limit resets.
Prompt 2
Walk me through installing the claude-wake CLI and running claude-wake doctor to grant Accessibility permission.
Prompt 3
Explain how claude-wake detects a Claude Code usage limit reset without screen scraping.
Prompt 4
Help me build the claude-wake menu bar app from source using the Tauri CLI.

Frequently asked questions

wtf is claude-wake?

A CLI and menu bar app that auto-resumes a stalled Claude Code VS Code session the moment your usage limit resets.

What language is claude-wake written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Tauri.

How hard is claude-wake to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-wake for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.