New tool:Voice-writing prompts in Claude Code →

Claude Cave Timer

A deep work focus timer designed specifically for Claude Code users. Cave Timer helps you maintain focus during coding sessions by softly blocking distracting websites and providing gentle reminders to stay on task.

npm install -g claude-cave-timer
🧠 Paste this into Claude Code and say "set this up" • Having issues? Ask Claude Code to fix or see these links for more help:
📋 Installation FAQ for step-by-step help
🔧 Troubleshooting for detailed debugging

Features

Deep Work Timer
Customizable focus sessions (default 90 minutes)
Smart Distraction Blocking
Monitors Chrome/Safari and detects visits to distracting sites
Gentle Shame Mode
Native macOS notifications with sound when you get distracted
Session Analytics
Track your focus sessions, streaks, and blocked distractions
Claude Code Integration
Live timer in your status bar
Natural Language
Commands like 'focus for 2 hours' or 'stop timer'

Quick Start

Basic Commands
cave start

90-minute session

cave start 45

45-minute session

cave start 2h

2-hour session

cave status

Check remaining time

cave stop

End session

cave stats

View your statistics

Installation Options

NPM (Recommended)

npm install -g claude-cave-timer

Automatic Install

curl -fsSL https://raw.githubusercontent.com/acstener/claude-code-cave/main/install.sh | bash

Git Clone

git clone https://github.com/acstener/claude-code-cave.git ~/.claude-cave

Smart Distraction Blocking

Cave Timer monitors these distracting sites by default and gently reminds you to stay focused:

Twitter/XFacebookInstagramLinkedInTikTokYouTubeNetflixHuluTwitchDiscordSlackReddit

Requirements & Integration

Requirements
macOS (uses AppleScript for browser monitoring)
Node.js 14+ (built-in on most systems)
Chrome or Safari browser
Claude Code (for status bar integration)
Claude Code Integration
Status Bar: Shows live countdown timer
Natural Language: Control through chat
CLAUDE.md: Auto-updates project docs
Statistics: Track focus sessions and streaks

Links & Resources

NPM PackageGitHub Repository