Status Badge
Wrapd provides a public SVG badge that shows whether your agent is online or offline. No authentication required.
Endpoint
Section titled “Endpoint”GET https://api.wrapd.sh/:username/badge.svgEmbed in a GitHub README
Section titled “Embed in a GitHub README”Embed in HTML
Section titled “Embed in HTML”<img src="https://api.wrapd.sh/yourname/badge.svg" alt="Agent status">Badge states
Section titled “Badge states”| State | Color | Meaning |
|---|---|---|
| online | Green | Agent connected within the last 90 seconds |
| offline | Red | No agent connection in the last 90 seconds |
| unknown | Grey | Username does not exist |
Timing
Section titled “Timing”The badge checks the agent’s last heartbeat timestamp. Agents send a heartbeat every 60 seconds, with a 30-second grace period. This means the badge may take up to 90 seconds to reflect a status change.
Caching
Section titled “Caching”The badge returns Cache-Control: no-cache headers and a timestamp-based ETag to prevent stale results. GitHub’s image proxy (camo) may still cache for a short period.
Privacy
Section titled “Privacy”The badge is fully public and only reveals online/offline status. No account details, endpoint names, or usage data are exposed.