VEKTRAUpdate auto-restarts with fresh code
v0.3.6ai-meter update always reboots the tray and integrated popup when finished — using the newly installed binary.
Latest
Vektra Software
PUBLICv0.3.6Vektra AI Meter
One install command from Vektra — tray icon, integrated top-bar dropdown on Wayland, autostart, and live usage for Grok Build, Codex, and Claude Code. The installer handles system dependencies and GTK4 layer-shell automatically. CodexBar-style integration. Local session data only.
Install
Served from vektraindustries.com/ai-tracker/install. May prompt for sudo once on Ubuntu / Pop!_OS. No follow-up steps.
Update
Pulls latest from GitHub, upgrades the venv, rebuilds integration on Wayland, and restarts the tray. Use ai-meter update --no-restart to skip restart.
Release timeline
Scroll the page to browse releases — the compass rail stays in sync. On desktop, hover the right rail and scroll (or ↑ ↓ / j k) to jump; click a bearing to select, double-click for details. In the modal, use ← → to step between releases.
01 of 14
layer-shell build without vapigen
v0.3.4ai-meter update no longer fails when vapigen is missing on Ubuntu/Pop!_OS.
Smooth panel + faster refresh
v0.3.3Background snapshot collection, in-place panel updates, and polished dropdown UX — no more stutter.
Reliable install on dirty trees
v0.3.2Install and update recover when the app directory has local changes or untracked files.
True one-command install
v0.3.1Single curl install handles apt packages, layer-shell build, autostart, and launch.
Full integrated top-bar experience
v0.3.0GTK4 layer-shell popup anchored to the top panel on Wayland — CodexBar-style.
Generated tray icon + dropdown anchor
v0.2.9Bundled Vektra tray assets and panel alignment under the status area.
CodexBar-inspired panel polish
v0.2.8Refined popover layout with provider accents, pills, and quota rows.
Panel dropdown + close button
2026-06-06CodexBar-style caret dropdown; close hides panel, tray keeps running.
ai-meter reboot command
2026-06-06One command to restart the top-bar indicator.
Linux top-bar parity
2026-06-06Autostart, systemd, single-instance lock, and rich quota UX.
Wayland panel fix
2026-06-06No more grabbing popup errors on COSMIC.
CodexBar-style usage panel
2026-06-06Custom popup with progress bars and dynamic tray meter.
Real-time usage limits
2026-06-06Live quota percentages for Codex, Grok, and Claude.
Capabilities
One command install
curl from vektraindustries.com installs apt packages (sudo once), builds GTK4 layer-shell on Wayland, enables autostart, and starts the meter.
Integrated top-bar dropdown
On Wayland (COSMIC, Sway, KDE), the panel anchors to the top bar via layer-shell — not a separate floating Qt window.
Live quota limits
Codex 5h/7d windows, Grok context %, Claude sessions — refreshed every 15s from local logs. No API keys.
Always on
Systemd user service + XDG autostart. ai-meter reboot and ai-meter update restart the tray and popup server.
Data sources
Grok Build
Reads ~/.grok/sessions — context window %, model, and estimated tokens.
Codex
5h and 7d quota percentages plus token usage from rollout logs.
Claude Code
Per-turn usage, model, and session title from project logs.
Local snapshot
Writes ~/.local/share/vektra-ai-meter/snapshot.json for every surface.
Surfaces
| Surface | Desktop | Entry |
|---|---|---|
| One-line install | Ubuntu, Pop!_OS, Debian | curl vektraindustries.com/ai-tracker/install | bash |
| Panel tray | COSMIC, GNOME, KDE, Xfce | auto on login |
| Integrated dropdown | Wayland (COSMIC, Sway, KDE) | built by install script |
| CLI snapshot | Any Linux desktop | ai-meter snapshot --write |
| Self-update | Installed instances | ai-meter update |
Quick start
$ curl -fsSL https://vektraindustries.com/ai-tracker/install | bash
$ ai-meter status
$ ai-meter update
Installs to ~/.local/bin/ai-meter with autostart. On Wayland, expect integrated_popup: true in status output.