gotify

# Gotify Notification Skill Send push notifications to your Gotify server when long-running tasks complete or important events occur. ## Purpose This skill enables Clawdbot to send push notifications via Gotify, useful for: - Alerting when long-running tasks complete - Sending status updates for background operations - Notifying of important events or errors - Integration with task completion hooks ## Setup Create the credentials file: `~/.clawdbot/credentials/gotify/config.json` ```json { "url": "https://gotify.example.com", "token": "YOUR_APP_TOKEN" } ``` - `url`: Your Gotify server URL (no trailing slash) - `token`: Application token from Gotify (Settings → Apps → Create Application) ## Usage ### Basic Notification ```bash bash scripts/send.sh "Task completed successfully" ``` ### With Title ```bash bash scripts/send.sh --title "Build Complete" --message "skill-sync tests passed" ``` ### With Priority (0-10) ```bash bash scripts/send.sh -t "Critical Alert" -m "Service down" -p 10 ``` ### Markdown Support ```bash bash scripts/send.sh --title "Deploy Summary" --markdown --message " ## Deployment Complete - **Status**: ✅ Success - **Duration**: 2m 34s - **Commits**: 5 new " ``` ## Integration with Task Completion ### Option 1: Direct Call After Task ```bash # Run long task ./deploy.sh && bash ~/clawd/skills/gotify/scripts/send.sh "Deploy finished" ``` ### Option 2: Hook Integration (Future) When Clawdbot supports task completion hooks, this skill can be triggered automatically: ```bash # Example hook configuration (conceptual) { "on": "task_complete", "run": "bash ~/clawd/skills/gotify/scripts/send.sh 'Task: {{task_name}} completed in {{duration}}'" } ``` ## Parameters - `-m, --message <text>`: Notification message (required) - `-t, --title <text>`: Notification title (optional) - `-p, --priority <0-10>`: Priority level (default: 5) - 0-3: Low priority - 4-7: Normal priority - 8-10: High priority (may trigger sound/vibration) - `--markdown`: Enable markdown formatting in message ## Examples ### Notify when subagent finishes ```bash # After spawning subagent sessions_spawn --task "Research topic" --label my-research # ... wait for completion ... bash scripts/send.sh -t "Research Complete" -m "Check session: my-research" ``` ### Notify on error with high priority ```bash if ! ./critical-task.sh; then bash scripts/send.sh -t "⚠️ Critical Failure" -m "Task failed, check logs" -p 10 fi ``` ### Rich markdown notification ```bash bash scripts/send.sh --markdown -t "Daily Summary" -m " # System Status ## ✅ Healthy - UniFi: 34 clients - Sonarr: 1,175 shows - Radarr: 2,551 movies ## 📊 Stats - Uptime: 621h - Network: All OK " ``` ## Workflow When the user says: - **"Notify me when this finishes"** → Add `&& bash scripts/send.sh "Task complete"` to their command - **"Send a Gotify alert"** → Run `bash scripts/send.sh` with their message - **"Push notification for task completion"** → Integrate into their workflow with appropriate title/priority Always confirm the notification was sent successfully (check for JSON response with message ID). ## Notes - Requires network access to your Gotify server - App token must have "create message" permission - Priority levels affect notification behavior on client devices - Markdown support depends on Gotify client version (most modern clients support it) ## Reference - Gotify API docs: https://gotify.net/docs/ - Gotify Android/iOS apps for receiving notifications