whatisgithub

What is unsnooze?

saaranshm/unsnooze — explained in plain English

Analysis updated 2026-05-18

59JavaScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A tool that automatically resumes AI coding assistants like Claude Code once their usage limit resets, so overnight work does not stay paused.

Mindmap

mindmap
  root((unsnooze))
    What it does
      Waits for limit reset
      Auto-resumes sessions
      Wakes tmux and Zellij panes
    Tech stack
      JavaScript
      Node.js
      tmux Zellij
    Use cases
      Overnight agent work
      Multi CLI tracking
      Revive closed sessions
    Safety
      Verifies pane identity
      Preview dry run mode
      No auto approve bypass
    Setup
      npm install
      unsnooze setup wizard

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

What do people build with it?

USE CASE 1

Automatically resume a Claude Code or Codex session overnight once its usage limit resets.

USE CASE 2

Track multiple paused AI coding sessions across different terminal tools from one shared list.

USE CASE 3

Preview exactly what unsnooze would type into a session before letting it actually resume anything.

USE CASE 4

Revive a session even after its terminal window or process has already closed.

What is it built with?

JavaScriptNode.jstmuxZellij

How does it compare?

saaranshm/unsnoozeandrewrk/mcserveangais/fable5-mc
Stars595959
LanguageJavaScriptJavaScriptJavaScript
Last pushed2013-04-10
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity3/53/52/5
Audiencedeveloperops devopsdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Node.js version 20 or newer.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Unsnooze solves a specific annoyance for people who use AI coding assistants like Claude Code, Codex CLI, Grok, Qwen Code, Kimi CLI, OpenCode, and Antigravity. These tools often let you run for hours, but they hit a usage limit, either every 5 hours or once a week, and the session simply stops with a message saying you have hit your limit. Unsnooze watches for that moment and automatically wakes the session back up the instant the limit resets, so work that would otherwise sit paused overnight can pick back up on its own. What makes it different from similar tools is that it works across many different AI assistants at once, not just one, and it can track many sessions running in parallel across tmux, Zellij, VS Code, and other desktop apps, using a single shared list and one background process. It can even bring back sessions whose terminal window or process has already closed, and it is designed to survive your laptop going to sleep during a long wait. The project puts a strong emphasis on trust and safety. It is described as a scheduler that presses keys for you, not a tool that automatically approves anything on your behalf. Before typing anything into a session, it checks that the terminal pane genuinely belongs to the same session it is tracking, using both an identity marker and a check that the original process is still alive, so it will not accidentally type into the wrong window. It also includes a preview mode that shows you exactly what it would type and why, without actually sending anything, and it deliberately avoids ever selecting risky options like bypassing permission prompts or auto-trusting a folder. Installing it is done with a standard command line package installer, using a setup command afterward to configure it. It requires a fairly recent version of a JavaScript runtime, and it is released under the MIT license, meaning it can be used freely, including for commercial purposes.

Copy-paste prompts

Prompt 1
Help me install and set up unsnooze to auto-resume my Claude Code sessions after hitting the usage limit.
Prompt 2
Explain how unsnooze verifies it is typing into the correct tmux pane before resuming a session.
Prompt 3
Show me how to use unsnooze preview mode to check what it would type without actually running anything.
Prompt 4
What is the difference between unsnooze and other Claude auto-retry tools for managing usage limits?

Frequently asked questions

What is unsnooze?

A tool that automatically resumes AI coding assistants like Claude Code once their usage limit resets, so overnight work does not stay paused.

What language is unsnooze written in?

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

What license does unsnooze use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is unsnooze to set up?

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

Who is unsnooze for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.