Skip to main content

Pilot Bot

Persistent automation agent — scheduled tasks, background jobs, heartbeat monitoring, 24/7 operation. Always runs on Sonnet for cost-effective automation.

pilot bot

Auto-initializes ~/.pilot/bot/ on first run. Only one global instance at a time (PID-enforced). Uses --continue to resume previous sessions.

Optional: Telegram

Install the Telegram Channels plugin to enable bidirectional messaging. Pilot Bot auto-detects it at launch — no extra configuration needed. Without Telegram, the bot works as a standalone automation tool.

Skills

SkillPurpose
bot-bootBoot sequence — health check, job registration via CronCreate, heartbeat setup
bot-heartbeatPeriodic health check (every 30 min), silent when no issues, dedup via lock file
bot-jobsManage scheduled jobs — list, add, remove, pause, resume, edit
bot-channel-taskChannel message flow — acknowledge, execute, report (when Telegram available)
bot-defaultsStandard behaviors — cron deduplication, reporting rules, error handling

Config

~/.pilot/bot/
├── .bot-pid # PID file (managed automatically)
└── JOBS.yaml # Scheduled job definitions (auto-created)

Jobs persist in JOBS.yaml. CronCreate registrations are session-scoped and re-registered on every boot.