====== AImeter – terminálový přehled limitů AI služeb ======

**AImeter** je open-source nástroj v Go pro terminál. Na jednom místě ukazuje využití API, kvótová okna a časy jejich obnovení u více AI služeb. Hodí se pro člověka v terminálu i pro automatizaci, protože vedle interaktivního rozhraní umí textový a JSON výstup.

===== K čemu slouží =====

Při práci s několika AI službami bývá těžké rychle zjistit, zda zbývá kapacita a kdy se limit obnoví. AImeter tento stav sjednocuje do jednoho přehledu. Není to nástroj pro volání modelů ani pro správu účtů. Je to lokální monitor spotřeby a limitů jejich API.

Vydání v0.1.4 podporuje tyto providery:

  * Anthropic
  * Codex
  * Z.AI
  * MiniMax
  * OpenRouter
  * ElevenLabs
  * Meshy

Lze přidat také vlastní provider. Konfigurace pro něj popisuje HTTP GET požadavek, Bearer token a cestu JSON Pointer, ze které má AImeter získat hodnotu.

===== Instalace =====

Na macOS lze použít Homebrew. Na macOS, Linuxu a Windows lze nástroj instalovat také přes Go:

<code bash>
brew install cookiebinary1/tap/aimeter
go install github.com/cookiebinary1/aimeter@latest
</code>

Projekt publikuje binární balíčky pro macOS, Linux a Windows, vždy pro architektury amd64 a arm64. Instalační skript pro macOS a Linux ověřuje kontrolní součet SHA-256 staženého release.

===== Základní použití =====

<code bash>
# Interaktivní terminálové rozhraní
aimeter

# Jednorázový přehled bez interaktivního rozhraní
aimeter -once

# Stabilní tabulka vhodná pro log, skript nebo agenta
aimeter -plain

# Strojově čitelná data
aimeter -json

# Pouze zdroje nalezených přístupových údajů, nikdy jejich hodnoty
aimeter -show-creds
</code>

Bez interaktivního terminálu program automaticky použije textový režim odpovídající přepínači ''-plain''. V interaktivním režimu klávesa ''r'' obnoví data a ''q'' program ukončí.

===== Přístupové údaje a bezpečnost =====

Pro API-key providery AImeter hledá klíče nejprve v proměnných prostředí, potom v souboru ''~/.config/aimeter/credentials.json'', dále v macOS Keychain a ve volitelném úložišti OMP. Konfiguračnímu souboru je vhodné nastavit práva pouze pro vlastníka:

<code bash>
chmod 600 ~/.config/aimeter/credentials.json
</code>

Podle dokumentace projekt klíče pouze čte, neposílá je jako argumenty procesů a neodesílá telemetrii. Přepínač ''-show-creds'' ukáže jen zdroj, ze kterého nástroj přístupové údaje našel, ne jejich obsah.

===== Poznámka k Anthropic =====

AImeter ukládá lokální cache údajů o využití Anthropic a omezuje dotazy na jejich API. Ve vydání v0.1.4 nepřekročí jeden dotaz na využití za 15 minut na jednom počítači; omezení platí i po restartu programu. Je proto potřeba počítat s tím, že zobrazené údaje mohou pocházet z cache.

Interaktivní obnova expirovaného Anthropic tokenu vyžaduje výslovné potvrzení. V neinteraktivních režimech ji program neprovádí.

===== Omezení =====

  * Zobrazené limity a jejich význam určuje API konkrétního providera.
  * Vlastní měsíční náklady v AImeteru jsou pomocný přehled. Nejde o náhradu oficiální fakturace poskytovatele.
  * Přehled ukazuje stav dostupný přes připojené účty. Neřeší výběr modelu, posílání promptů ani správu předplatného.

===== Zdroje =====

  * [[https://github.com/cookiebinary1/aimeter|AImeter – oficiální repozitář na GitHubu]]
  * [[https://github.com/cookiebinary1/aimeter/blob/main/README.md|AImeter README – instalace, konfigurace a přepínače]]
  * [[https://github.com/cookiebinary1/aimeter/releases/tag/v0.1.4|AImeter v0.1.4 – aktuální release při sepsání článku (20. 10. 2026)]]