What happens if the bot process crashes?

The skill includes 'KeepAlive' configurations in its plist templates to ensure launchd automatically restarts the process, along with tools to clear stale PID files.

Can I view the bot's activity logs through Claude?

Yes, the skill provides specific commands to tail stdout/stderr logs and query NDJSON audit logs to track bot events and errors.

How does it handle Google OAuth token expiration?

The skill includes procedures for silent token refreshing via a background Swift binary and provides a step-by-step fix for 'invalid_grant' errors when refresh tokens expire.

What services does this skill control?

It manages two primary services: the always-on Bot Daemon for real-time Telegram polling and the Scheduled Digest service for periodic email summaries.

Is this skill compatible with Linux systems?

Currently, this skill is specifically optimized for macOS environments as it utilizes launchd and .plist configurations for process management.

Gmail Commander Bot Control

Name: Gmail Commander Bot Control
Author: terrylica

byterrylica

•

Productivity & Workflow

Manages the lifecycle and health of the Gmail Commander daemon and scheduled email digests via launchd.

This skill provides comprehensive management for the Gmail Commander bot, a specialized service that bridges Gmail functionality with Telegram. It enables Claude to monitor process status, manage launchd plists, handle automated OAuth token refreshing, and troubleshoot common daemon issues like stale PIDs or expired refresh tokens. It is an essential tool for developers and power users maintaining a reliable, self-hosted email automation workflow on macOS.

Key Features

01Automated OAuth token refreshing and invalid_grant troubleshooting

0219 GitHub stars

03Resource usage monitoring for memory, CPU, and network overhead

04Real-time log monitoring for bot polling and scheduled digests

05Full daemon lifecycle management (start, stop, restart, status) via launchd

06Stale PID detection and emergency process recovery

Use Cases

01Restarting the Gmail-to-Telegram bot after a configuration update or environment change

02Recovering a stalled bot process caused by an unclean exit or an expired Google OAuth refresh token

03Debugging email sync failures by inspecting centralized launchd logs and NDJSON audit files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills bot-process-control

For use in Claude.ai and ChatGPT

Download Skill