skills/metrix.bar/metrix-bar

metrix-bar

Installation
SKILL.md

Metrix.Bar dashboards

Metrix.Bar displays native menu bar and system tray dashboards, the same dashboards in screen sidebars and windows, and, where the system provides a container, in system widgets. Each .bar file declares metadata, permissions, inputs, optional plain-text setup instructions, and a persistent JavaScript Worker.

Get the app ready

First distinguish an app that is not installed, an installed app that is not running, and a running app that is not connected. Do not reinstall an existing app. Follow installation and startup to detect the actual OS/CPU, select a compatible GUI package from the live release index, verify its SHA-256, install within the user's requested scope, and launch it. Prefer stable; use preview only when the user explicitly chooses it. Do not bypass OS protection or elevate privileges on your own.

If installed but stopped, launch the existing app. If running but disconnected, open Agent, enable Enable local API, confirm Running, and ask the user to send Copy Prompt to this agent session. It supplies the actual base URL and token. Never extract tokens from private local app configuration.

Connect to the installed app

Use the base URL and Bearer token supplied from Agent. The preferred default port is 6387; the actual address can differ. GET /v0/health is unauthenticated. Every other route requires Authorization: Bearer <token>. Requests with an Origin header are rejected. Keep tokens and secrets out of source, fixtures, logs, and responses to the user.

Check GET /v0/health without authentication for reachability, then authenticated GET /v0/dashboards to verify access. A successful health request alone does not verify the token. Use the supplied address, not an assumed default.

The website publishes documentation and /openapi.json; dashboard operations run against the installed app's loopback URL.

Get an official dashboard

Installs
57
First Seen
Oct 11, 2026