Desktop and Cinnamon

The Debian package is the complete Linux experience: native Wails window, CLI/server, systemd user service, application launcher, and Cinnamon panel applet.

Desktop application

Launch QuotaDeck from the application menu. The window starts or reuses the local service and loads the dashboard from 127.0.0.1.

Cinnamon applet

After installing the .deb:

1. Open System Settings → Applets.
2. Find QuotaDeck.
3. Add it to the panel.

The applet reads the loopback API and starts the packaged user service when necessary. Its menu summarizes every quota window and opens the full dashboard for details. In the applet settings, Plan / account selects the subscription to represent in the panel and Indicator selects one of its quota windows. Both default to automatic selection of the tightest available window.

Add the QuotaDeck applet to the panel multiple times to display as many indicators as needed. Every instance has independent account and quota-window settings, and automatically shows the Claude, Codex, or Z.ai provider glyph beside its percentage. A transient local API error keeps the last value visible while the applet retries; offline appears only after repeated failures.

To install only the applet from a source checkout:

make package-cinnamon

Install the generated zip through Cinnamon's applet settings.

User service

quotadeck service install --user
quotadeck service status
quotadeck service uninstall --user

The package installs a systemd user unit. Logs are available with:

journalctl --user -u quotadeck.service -f