poke-assistant
Send messages and notifications to Poke (poke.com) via webhook API. Use when alerting the user, sending task completion notifications, status updates, reminders, or any message to their Poke assistant.
When & Why to Use This Skill
The Poke Assistant skill enables Claude to send real-time notifications and messages directly to your Poke account via a webhook API. By bridging Claude with Poke's support for iMessage, SMS, and WhatsApp, this tool ensures you receive critical updates, task completions, and system alerts on your preferred messaging platform, enhancing workflow visibility and responsiveness.
Use Cases
- Long-Running Task Alerts: Automatically notify the user via iMessage or WhatsApp when a time-consuming script, build, or data processing task has finished.
- DevOps & CI/CD Monitoring: Send immediate notifications for deployment statuses, build failures, or security vulnerabilities directly to a mobile device.
- Incident Response & Error Reporting: Alert developers or system administrators instantly when critical production errors or downtime are detected in the logs.
- Daily Productivity Summaries: Generate and send a concise summary of daily achievements, pending tasks, or meeting notes to your personal Poke assistant.
- Automated Reminders: Use Claude to trigger scheduled reminders for meetings, deadlines, or follow-ups that appear as native mobile notifications.
| name | poke-assistant |
|---|---|
| description | Send messages and notifications to Poke (poke.com) via webhook API. Use when alerting the user, sending task completion notifications, status updates, reminders, or any message to their Poke assistant. |
Poke Assistant
Overview
Send messages to your Poke assistant via the inbound webhook API. Poke is a conversational AI assistant that supports iMessage, SMS, and WhatsApp messaging. This skill enables Claude to send you notifications, alerts, and updates directly to your Poke.
When to Use
- Notifying the user when a long-running task completes
- Sending error alerts or warnings that need attention
- Providing status updates on build, test, or deployment progress
- Sending reminders or summaries
- Alerting about important events (CI failures, security issues, etc.)
Prerequisites
- Poke account at poke.com
POKE_API_KEYenvironment variable
Installation
Getting Your API Key
- Go to poke.com/settings
- Navigate to the Advanced section
- Generate or copy your API key
- Add to your shell profile:
echo 'export POKE_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc
Quick Start
Send a simple message:
python scripts/send_message.py -m "Hello from Claude Code!"
Pipe content to Poke:
echo "Build completed successfully" | python scripts/send_message.py
Command Reference
python scripts/send_message.py [options]
Options:
-m, --message TEXT Message to send to Poke
-v, --verbose Show detailed output
-h, --help Show help message
Input:
Message can be provided via -m flag or piped to stdin.
If both are provided, -m takes precedence.
Exit codes:
0 Success
1 Missing message or API key
2 API error (authentication, rate limit, etc.)
3 Network error
Examples
Task Completion Alert
python scripts/send_message.py -m "Build completed: 42 tests passed, 0 failed"
Error Notification
python scripts/send_message.py -m "ERROR: Deployment to production failed. Check logs."
Pipe Command Output
git log --oneline -5 | python scripts/send_message.py -m "Recent commits:
$(cat)"
Status Update with Details
python scripts/send_message.py -m "Code review complete:
- 3 files changed
- 2 suggestions made
- Ready for merge"
Alert on Test Failure
npm test || python scripts/send_message.py -m "Tests failed! Check the output."
Workflow Integration
Notify After Long Tasks
When running tasks that take time, notify on completion:
# Run build and notify
npm run build && python scripts/send_message.py -m "Build finished successfully" \
|| python scripts/send_message.py -m "Build failed!"
Daily Summary
Send a summary of work done:
python scripts/send_message.py -m "Daily summary:
- Implemented user auth
- Fixed 3 bugs
- Updated documentation"
Best Practices
When to Send Notifications
- Tasks taking longer than 2-3 minutes
- Errors requiring user attention
- Important milestones (deployment, release)
- Security-related alerts
When NOT to Send
- Routine operations that complete quickly
- Every small step (avoid notification fatigue)
- Sensitive information (credentials, tokens)
Message Guidelines
- Keep messages concise but informative
- Include actionable context (what happened, what to do)
- Use clear formatting for multi-line messages
Troubleshooting
"POKE_API_KEY environment variable not set"
Set your API key:
export POKE_API_KEY="your-api-key"
Or add to ~/.zshrc for persistence.
"API returned 401: Unauthorized"
Your API key is invalid or expired. Generate a new one at poke.com/settings.
"API returned 429: Too Many Requests"
You're being rate limited. Wait a few minutes before sending more messages.
"Network error: Connection refused"
Check your internet connection. The Poke API requires network access.
Message not appearing in Poke
- Verify your API key is correct
- Check that messaging is enabled in your Poke settings
- Ensure your messaging channel (iMessage/SMS/WhatsApp) is configured