Automatic tailnet discovery
Reads local Tailscale capability advertisements directly from tailscale status --json. Any Tailscale Service advertising tcp:443 appears automatically—no hardcoded URLs, OAuth apps, or API keys.
Omarchy Bar Widget · v1.0.1 · MIT
A native Quickshell widget for the Omarchy bar. Automatically discovers your Tailscale Services on port 443, probes live HTTPS reachability and latency, and opens any service in one click or keystroke.
omarchy plugin add https://github.com/digitalbase/omarchy-tailscale-services --enable Every discovered HTTPS service responded with HTTP 100–499 and valid TLS.
Some services are up while one or more failed to respond or have no active host.
No services responded, Tailscale is disconnected, or discovery hit an error.
Capabilities
No browser bookmarks to keep in sync and no dashboards to keep pinned. Every HTTPS service your tailnet advertises shows up right where you already look.
Reads local Tailscale capability advertisements directly from tailscale status --json. Any Tailscale Service advertising tcp:443 appears automatically—no hardcoded URLs, OAuth apps, or API keys.
Probes up to 8 services in parallel with curl using strict TLS verification, 2s connect and 5s total timeouts. Reports HTTP status codes and round-trip latency in milliseconds.
Matches each service’s advertised IP addresses against peer PrimaryRoutes—including routes hosted by your local machine—so you know which server is currently answering.
Built on Omarchy’s KeyboardPanel. Move with arrow keys, hit Enter to launch via xdg-open, press R to refresh, or right-click the bar icon for an instant background re-probe.
Exposes open, close, toggle, and refresh IPC actions under io.github.digitalbase.tailscale-services so you can bind your tailnet service drawer to any Hyprland shortcut.
Enforces strict size caps before JSON parsing (4 MiB status input, 256 KiB panel output) with a 10s deadline that cleanly kills and reaps hung subprocesses.
Interaction
Designed to feel indistinguishable from Omarchy’s built-in shell panels.
xdg-open
This widget specifically lists Tailscale Services advertised on
tcp:443 and visible to your signed-in Tailscale user.
tcp:443 in local capability maps PrimaryRoutes (including local device) login.tailscale.com/admin/services via the Admin button Note: Reachability checks verify TLS and HTTP responsiveness (100–499)—not deep application health. If discovery fails, the panel keeps the last known list visible alongside an error banner.
Setup
Requires Omarchy Quattro with its Quickshell plugin system, plus a signed-in Tailscale client with MagicDNS enabled.
omarchy pkg add python curl tailscale xdg-utils omarchy plugin add https://github.com/digitalbase/omarchy-tailscale-services --enable { "id": "io.github.digitalbase.tailscale-services", "refreshSeconds": 120 } Privacy & Hardening
Tailnet metadata is sensitive. The plugin is engineered to stay strictly in memory and never leak private hostnames or CLI output.
Everything comes from your active local Tailscale session. Removing the plugin leaves behind no daemon, config file, or stored secret.
Probes pass --disable, --noproxy "*", and
--proto =https—ignoring ~/.curlrc and proxy variables,
verifying TLS certificates, sending no credentials, and never following redirects.
Raw Tailscale status JSON and CLI stderr are never echoed into the panel UI, and the helper runs unprivileged under your normal user account.