claude-code-task
by vsevolodustinov
Coding Agents & IDEsBrief
Run Claude Code tasks in background with automatic result delivery.
Description
What This Skill Does
Runs Claude Code in a detached background process and delivers results to Telegram or WhatsApp when complete. Supports coding, codebase research, file analysis, content generation, and multi-step automations. Includes strict Telegram thread-safe routing, silent heartbeat pings during execution, and iterative continuation mode.
Runs Claude Code on a Max subscription with zero API token cost while the main agent session stays free for other work.
When to Use It
- Refactoring a codebase overnight and receiving the result on mobile
- Running competitive research while away from the terminal
- Analyzing production logs and getting a structured summary in a Telegram thread
- Generating project documentation with WhatsApp delivery
- Running multi-step automation workflows without monitoring the process
Example Workflow
User asks: Refactor the auth module to use JWT and notify me in my Telegram thread
- 1
Saves task prompt to /tmp/cc-prompt.txt to avoid shell quoting issues
- 2
Validates Telegram thread routing with --validate-only flag before launch
- 3
Launches run-task.py via nohup with the thread session key and a 900s timeout
- 4
Background process runs Claude Code and sends silent heartbeat pings to the thread every 60 seconds
- 5
On completion, delivers the result to the Telegram thread and wakes the agent for a visible continuation summary turn
Refactored auth module with JWT support delivered as a Telegram thread message, followed by an agent continuation turn summarizing changes and next steps
Requirements
- Claude Max subscription ($200/month)
Installation
clawhub install vsevolodustinov/claude-code-taskRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.