---
title: "OpenRouter Meter — Lab — Ronan Rodrigo Nunes"
description: "Seu saldo da OpenRouter na barra de menus do macOS e o consumo completo num clique: tokens, chamadas, custo e modelos de hoje e dos últimos sete dias."
canonical: "https://ronanrodrigo.dev/lab/openrouter-meter"
markdown: "https://ronanrodrigo.dev/lab/openrouter-meter.md"
last-updated: ""
---
# OpenRouter Meter

_Lab · app de barra de menus do macOS_

Seu saldo da OpenRouter na barra de menus do macOS e o consumo completo num clique: tokens, chamadas, custo e modelos de hoje e dos últimos sete dias.

Stack: macos, swiftui, openrouter, homebrew, open source

## Instalação

```sh
brew install --cask ronanrodrigo/tap/openrouter-meter
```

Não é notarizado: o cask remove a quarentena para o app abrir normalmente.
Com o nome curto, o Homebrew 7 pede confiança antes (`brew trust --cask ronanrodrigo/tap/openrouter-meter`); o comando acima, com o nome completo, já passa por essa checagem.

![Print real do OpenRouter Meter em modo escuro: na barra de menus do macOS, o ícone de medidor com o saldo US$ 87,93; logo abaixo, o painel com saldo restante de US$ 122,07 de US$ 210,00 consumidos (58%), 34 de 1.000 requisições gratuitas usadas e, em cartões separados, tokens, chamadas, custo e modelos principais de hoje e dos últimos sete dias.](/lab/openrouter-meter/barra-e-painel.png)

_Print de uma conta real: o item na barra de menus e o relatório completo, na mesma imagem._

## O que ele mostra

Tudo o que importa fica visível sem abrir nada: o saldo na barra de menus e o restante num clique.

- **Saldo e medidor de consumo** — Quanto ainda resta de crédito, em dólar, sempre à vista na barra de menus. No painel, o medidor mostra a fatia já consumida do total da conta.
- **Cota de requisições gratuitas** — Quantas requisições gratuitas já foram usadas e quantas ainda restam, com a barra de proporção do período.
- **Tokens, chamadas e custo** — Hoje e nos últimos sete dias: total de tokens, número de chamadas e o custo estimado de cada janela.
- **Os modelos que mais pesaram** — Os modelos que mais consumiram tokens no período, ranqueados e com a proporção de cada um.

## De onde vêm os números

Os dados vêm do próprio OpenRouter e do histórico local do Hermes. A origem usada fica indicada no painel.

### Saldo e uso pela API da OpenRouter

O saldo, o total de crédito, o medidor de consumo e a cota de requisições gratuitas vêm da API de créditos da OpenRouter, com a chave da sua conta.
A chave fica no Keychain do macOS ou em $HERMES_HOME/.env, nunca no código.

### Tokens e modelos pelo histórico do Hermes

Sem uma chave de provisioning da OpenRouter, o detalhamento de tokens, chamadas, custo e modelos é lido do histórico local do Hermes ($HERMES_HOME/state.db), em modo somente leitura.
Quando é essa a origem, o painel exibe Histórico local do Hermes no cabeçalho — você sabe de onde veio cada número.

## Onde encontrar o resto

- Repositório: [github.com/ronanrodrigo/openrouter-meter](https://github.com/ronanrodrigo/openrouter-meter).
- Releases: [github.com/ronanrodrigo/openrouter-meter/releases](https://github.com/ronanrodrigo/openrouter-meter/releases) — zip universal para arm64 e x86_64.
- Versão anterior desta página: [openrouter-meter.vercel.app](https://openrouter-meter.vercel.app).

Página: [OpenRouter Meter](/lab/openrouter-meter) · [Voltar ao lab](/lab)