Claude Code Dispatch

Claude Code Dispatch

One-command dispatch of development tasks to [Claude Code](https://docs.anthropic.com/en/docs/claude-code) with automatic Telegram notification on completion. Zero polling, zero token waste.

An [OpenClaw](https://github.com/openclaw/openclaw) skill that wraps Claude Code CLI into a fire-and-forget workflow: dispatch a task, walk away, get notified when it's done.

Features

• Fire & Forget — nohup dispatch, automatic callback via Stop Hook
• Agent Teams — Multi-agent parallel development with dedicated Testing Agent via structured --agents JSON
• Cost Controls — --max-budget-usd spend cap + --max-turns limit + --fallback-model for overload resilience
• Git Worktree Isolation — --worktree for parallel tasks in isolated branches
• Custom Subagents — Define specialized agents (security reviewer, testing agent, etc.) via --agents-json
• Auto-Callback — Group notifications, DM callbacks, webhook wake events
• Rich Notifications — Task status, duration, test results, file tree — all in one Telegram message
• PTY Wrapper — Reliable execution even in non-TTY environments (CI, exec, cron)
• MCP Integration — Load MCP servers for tasks via --mcp-config
• System Prompt Customization — --append-system-prompt / --append-system-prompt-file

Architecture

dispatch.sh
  → write task-meta.json
  → launch Claude Code via claude_code_run.py (PTY)
  → [Agent Teams: --agents JSON defines Testing Agent + custom subagents]
  → Claude Code finishes → Stop/TaskCompleted hook fires automatically
    → notify-agi.sh reads meta + output
    → writes latest.json
    → sends Telegram notification
    → writes pending-wake.json (heartbeat fallback)

Quick Start

Prerequisites

• OpenClaw installed and configured
• Claude Code CLI (claude) installed
• A Telegram bot configured in OpenClaw (for notific