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

{
  "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 scripts/send.sh "Task completed successfully"

With Title

bash scripts/send.sh --title "Build Complete" --message "skill-sync tests passed"

With Priority (0-10)

bash scripts/send.sh -t "Critical Alert" -m "Service down" -p 10

Markdown Support

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

# 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:

# 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

# 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

if ! ./critical-task.sh; then
  bash scripts/send.sh -t "⚠️ Critical Failure" -m "Task failed, check logs" -p 10
fi

Rich markdown notification

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