Introduction
# 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.