Pocket Alert – Push Notifications for iOS and Android

# Pocket Alert This skill enables interaction with the [Pocket Alert](https://pocketalert.app) service through its CLI tool. ## Prerequisites The `pocketalert` CLI must be installed and authenticated: ```bash # Install (if not already installed) # Download from https://info.pocketalert.app/cli.html and extract to /usr/local/bin/ # Authenticate with your API key pocketalert auth <your-api-key> ``` ## Quick Reference ### Send Push Notifications ```bash # Basic notification pocketalert send -t "Title" -m "Message" # Full form pocketalert messages send --title "Alert" --message "Server is down!" # To specific application pocketalert messages send -t "Deploy" -m "Build completed" -a <app-tid> # To specific device pocketalert messages send -t "Alert" -m "Check server" -d <device-tid> # To all devices pocketalert messages send -t "Alert" -m "System update" -d all ``` ### List Resources ```bash # List last messages pocketalert messages list pocketalert messages list --limit 50 pocketalert messages list --device <device-tid> # List applications pocketalert apps list # List devices pocketalert devices list # List webhooks pocketalert webhooks list # List API keys pocketalert apikeys list ``` ### Manage Applications ```bash # Create application pocketalert apps create --name "My App" pocketalert apps create -n "Production" -c "#FF5733" # Get application details pocketalert apps get <tid> # Delete application pocketalert apps delete <tid> ``` ### Manage Devices ```bash # List devices pocketalert devices list # Get device details pocketalert devices get <tid> # Delete device pocketalert devices delete <tid> ``` ### Manage Webhooks ```bash # Create webhook pocketalert webhooks create --name "GitHub Webhook" --message "*" pocketalert webhooks create -n "Deploy Hook" -m "Deployed %repository.name% by %sender.login%" pocketalert webhooks create -n "CI/CD" -m "*" -a <app-tid> -d all # List webhooks pocketalert webhooks list # Get webhook details pocketalert webhooks get <tid> # Delete webhook pocketalert webhooks delete <tid> ``` ## Message Template Variables When creating webhooks, you can use template variables from the incoming payload: ```bash pocketalert webhooks create \ --name "GitHub Push" \ --message "Push to %repository.name%: %head_commit.message%" ``` ## Configuration View or modify configuration: ```bash # View config pocketalert config # Set API key pocketalert config set api_key <new-api-key> # Set custom base URL (for self-hosted) pocketalert config set base_url https://your-api.example.com ``` Configuration is stored at `~/.pocketalert/config.json`. ## CI/CD Integration Examples ```bash # GitHub Actions / GitLab CI pocketalert send -t "Build Complete" -m "Version $VERSION deployed" # Server monitoring with cron */5 * * * * /usr/local/bin/pocketalert send -t "Server Health" -m "$(uptime)" # Service check script if ! systemctl is-active --quiet nginx; then pocketalert send -t "NGINX Down" -m "NGINX is not running on $(hostname)" fi ``` ## Error Handling The CLI returns appropriate exit codes: - `0` - Success - `1` - Authentication or API error - `2` - Invalid arguments Always check command output for error details.