CCPulse 💙

Keep your Claude Code token window alive with periodic pulses

한국어 | English

curl -fsSL https://raw.githubusercontent.com/renechoi/ccpulse/main/install.sh | bash

iwr -useb https://raw.githubusercontent.com/renechoi/ccpulse/main/install.ps1 | iex

git clone https://github.com/renechoi/ccpulse.git
cd ccpulse
npm install
npm start

Claude Code uses a 5‑hour token window that starts from your first usage:

• First use at 3 PM → Window ends at 8 PM (5 hours)
• First use at 6 AM → Window ends at 11 AM (5 hours)

The Solution: Automatically send a minimal "Hello" pulse at your preferred time (e.g., 6:00 AM) so your 5‑hour window starts when you want (e.g., aligned with working hours).

• 🕐 Schedule Management: Auto-run at your preferred time
• 🎨 GUI Interface: Easy configuration with visual interface
• 🌐 Multi-language: English/Korean support with easy switching
• 📊 Real-time Logs: Monitor execution status
• 🔄 Mock/Real Modes: Test safely before actual execution
• 🖥️ System Tray: Runs quietly in background
• ⚡ Multiple Schedules: Set multiple trigger times
• 🔔 Notifications: Get alerts on successful resets

• Pulse Time: 6:00 AM (example)
• Message: "Hello" (customizable)
• Mode: Start with Mock mode → Switch to Real mode
• Language: Click the language button to switch

# From project directory
npm install
npm start

# (Optional) Double-click desktop shortcut if you created one

• macOS: ~/Library/Application Support/ccpulse/
• Linux: ~/.config/ccpulse/
• Windows: %APPDATA%/ccpulse/

# macOS
launchctl load ~/Library/LaunchAgents/com.claude.ccpulse.plist

# Linux
systemctl --user enable ccpulse.service

# Windows
# Automatically added to startup programs

export CCPULSE_MOCK_MODE=false    # Force Real mode
export CCPULSE_AUTO_START=true    # Enable auto-start
export CCPULSE_LANGUAGE=en        # Set default language (en/ko)

Global CLI is not bundled yet. Use the UI or edit schedules in the app.

• Node.js 16.0.0 or higher
• Claude Code installed and configured
• macOS: Terminal automation permission required

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

# Clone and install
git clone https://github.com/renechoi/ccpulse.git
cd ccpulse
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

MIT License © 2025 renechoi

# Allow Terminal automation access
System Preferences > Privacy & Security > Automation > Terminal ✓

# macOS
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Windows
# Download from https://nodejs.org

# Real-time log monitoring
tail -f ~/.config/ccpulse/logs.txt

# Check last 50 lines
tail -n 50 ~/.config/ccpulse/logs.txt

xattr -cr /Applications/CCPulse.app

graph LR
    A[User Sets Schedule] --> B[App Waits]
    B --> C{Scheduled Time?}
    C -->|Yes| D[Execute Claude CLI]
    D --> E[Send Pulse Message]
    E --> F[Token Window Activated]
    F --> G[Log Success]
    C -->|No| B

• After sending the message to Claude, CCPulse waits 10 seconds before sending exit.
• Rationale: Claude TUI may need a few seconds to register the first turn; this buffer prevents the session from closing too early.

• Report Issues
• Wiki Documentation
• Latest Releases
• Discussions

Made with ❤️ for the Claude community
⭐ Star us on GitHub!