wake-up-cc

한국어 | English

Wake up Claude Code remotely via Telegram.

Start a Claude Code background agent on your desktop from anywhere — just send a Telegram message, then continue working through the Claude app's agent management.

How it works

Telegram message → Bot receives → Spawns claude --bg → Manage via Claude app agents tab

Features

• No GUI terminal required - Runs as background agent, no remote desktop needed
• Cross-platform - macOS and Windows support
• Auto-start - System service for automatic startup on login
• Remote control - Manage sessions via Claude desktop/mobile app

Installation

npm install -g wake-up-cc

Or locally:

git clone <repo>
cd wake-up-cc
npm install

Configuration

Config is stored in ~/.wake-up-cc.json.

Interactive setup (recommended)

wake-up-cc --setup

Prompts for bot token, default working directory, and Claude command.

CLI arguments

wake-up-cc --token YOUR_BOT_TOKEN --work-dir /path/to/project --allowed-users 123456789

Environment variables

export WAKE_UP_CC_BOT_TOKEN=your_token
export WAKE_UP_CC_WORK_DIR=/path/to/project
export WAKE_UP_CC_CLAUDE_CMD=claude
export WAKE_UP_CC_ALLOWED_USERS=123456789

Priority

CLI args > Environment variables (WAKE_UP_CC_*) > Config file (~/.wake-up-cc.json) > Defaults

Security

Set allowedUsers to restrict who can control the bot. Get your Telegram user ID from @userinfobot. If allowedUsers is empty, anyone can use the bot.

Usage

wake-up-cc

Background service

Auto-starts on login, restarts on crash.

macOS:

npm run setup:macos

Windows (Admin PowerShell):

npm run setup:windows

Service management

| | macOS | Windows | |---|---|---| | Status | launchctl list \| grep wake-up-cc | Get-ScheduledTask -TaskName 'wake-up-cc' | | Stop | launchctl unload ~/Library/LaunchAgents/com.wake-up-cc.plist | Stop-ScheduledTask -TaskName 'wake-up-cc' | | Remove | npm run uninstall:macos | npm run uninstall:windows |

Telegram commands

| Command | Action | |---|---| | Any text | Start Claude Code background agent in default directory | | Message containing a path (e.g. /Users/me/project) | Start agent in that directory | | /status | Check current session status | | /kill | Terminate the running session |

Path examples

/Users/me/dev/project 에서 시작해줘
~/dev/myapp
/home/user/workspace/foo

If the message contains a valid directory path, Claude Code starts there. Otherwise, it uses the configured default directory.

Managing agents

After starting a session via Telegram, manage it through the Claude app:

1. Open Claude desktop or mobile app
2. Go to the Agents tab
3. Find your background agent session
4. Send messages, view progress, and control the agent

Prerequisites

• Claude Code 2.x or later (with --bg support)
• Node.js 18+
• Telegram bot token
• Claude authentication (API key or OAuth)

macOS specific

• Claude command: claude (uses configured path, configurable via --claude-cmd)
• LaunchAgent for auto-start

Windows specific

• claude command must be in PATH
• Scheduled Task for auto-start (requires admin)

Config file

~/.wake-up-cc.json

{
  "botToken": "YOUR_TELEGRAM_BOT_TOKEN",
  "workDir": "/Users/me/dev",
  "claudeCmd": "claude",
  "allowedUsers": [123456789]
}

License

MIT