--- title: "Metrix.Bar — Menu Bar & System Tray Metrics Dashboard" description: "Track metrics from your menu bar or system tray on macOS, Windows, and Linux (Exp). Connect your agent to create, customize, and manage dashboards with your own data." canonical: "https://metrix.bar/" language: "en" --- # Metrix.Bar > Your metrics, in the menu bar. Native menu bar and system tray dashboards for macOS, Windows, and Linux (Exp). The numbers you keep checking, right where you already look. ## One number, three ways in Glance at the menu bar, move to the edge of the screen, or press a key from any app. Each dashboard picks its own ways in, and how its panel opens. - On macOS the value sits in the menu bar, beside the icon. - On Windows the tray shows the icon; the value is in its tooltip. - On Linux (Exp) the tray shows the icon; the value is the first item in its menu. Screen sidebars and dialogs need native window positioning, which native GNOME Wayland doesn't offer. ## Say what you want to watch. It lands in your menu bar. Connect once, then let Claude Code, Codex, or Cursor create, edit, validate, and configure dashboards, refresh data, and manage your installed dashboards. You ask your agent for a GitHub repository dashboard. It validates the .bar file, installs the dashboard, sets the repository, and refreshes the data. The star count appears in the menu bar, and a click opens the full panel. - **Create and edit**: Start with a request, connect data, and shape your metrics and panels. - **Configure and manage**: Set dashboard inputs, refresh data, and manage installed dashboards. - **Validate and diagnose**: Check configuration and runtime results, then resolve issues and refine. ### Try asking > Put my GitHub repository’s stars, forks, and latest release in the menu bar. ### Install the Agent Skill ```bash npx skills add https://metrix.bar ``` On the Agent page, use Copy Prompt and send it to your agent to connect. [Read the Agent guide](https://metrix.bar/docs/agents) ## Official dashboards - **Claude Code**: Subscription usage and reset times - **GitHub Repository**: Stars, forks and repository activity - **Weather**: Current conditions and a 6-day forecast - **Codex**: Codex plan usage and reset times - **Umami**: Website traffic from Umami Analytics [Browse gallery](https://metrix.bar/gallery) ## One file holds the whole dashboard Your agent writes it, and you can read it. Each dashboard is a single .bar file you can edit, export, and share. [Read .bar specification](https://metrix.bar/docs/bar-format) ## Built to live in your menu bar - **Native on three platforms**: Panels and windows are native UI, not a web view, on macOS, Windows, and Linux (Exp). - **Local data, isolated credentials**: Dashboard data and settings stay local; API keys live in the OS credential store. - **Permissions you can read**: A .bar file lists the origins it may reach. Requests anywhere else are refused. - **A local API for your agent**: Reachable from this machine only, behind a bearer token you can reset. ## Put your first number in the menu bar 1. **Install and launch the app**: Choose the build for your system, then launch it. 2. **Install the Skill**: Add the Agent Skill to your coding assistant. 3. **Connect your agent**: On the Agent page, use Copy Prompt and send it to your agent. 4. **Ask for your metrics**: Describe what matters and let your agent create and refine your dashboard. [Agent guide](https://metrix.bar/docs/agents) ## Download v0.1.1 · macos 12.0+ · windows 10+ · linux - [Download](https://downloads.agili.app/stable/metrix-bar/releases/0.1.1/build-34/macos-arm64/metrix-bar-0.1.1-arm64.dmg) ## Documentation ### Getting Started - [Introduction](https://metrix.bar/docs/introduction.md): Overview of Metrix.Bar, ready-to-use dashboards, and AI agent integration. - [Installation & Updates](https://metrix.bar/docs/installation.md): System requirements, installation instructions, and automatic update settings. - [Using Dashboards](https://metrix.bar/docs/dashboards.md): Managing official dashboards, configuring inputs, previewing, and menu bar integration. ### AI Agents - [AI Agents](https://metrix.bar/docs/agents.md): Connect Claude Code, Codex, or Cursor to Metrix.Bar using the Agent Skill and local API. - [Local API Reference](https://metrix.bar/docs/local-api.md): HTTP REST API specification for AI agents and local automation. ### Format Reference - [The .bar Format Specification](https://metrix.bar/docs/bar-format.md): Complete specification for .bar v0 dashboards in Metrix.Bar. - [Dashboard Registries](https://metrix.bar/docs/registries.md): How Metrix.Bar discovers, verifies, and installs .bar dashboards from remote registries. - [Dashboard Development](https://metrix.bar/docs/tech-stack.md): Build native component trees, manage state, and choose optional libraries for .bar dashboards. - [Native UI Components](https://metrix.bar/docs/components.md): Complete catalog of native UI components, props, layouts, and event handlers for .bar v0. ### Security & Privacy - [Security & Privacy](https://metrix.bar/docs/privacy.md): Local data, credential protection, permissions, and usage analytics controls.