Tidemark

See how much of your AI quota is left — on your Linux desktop.

---

recording_20260828_20-09-52.mp4

---

Tidemark shows every rate-limit window your AI providers report: how much you have burned, when it resets, and whether your current pace gets you there. One card per account, side by side, so you can tell at a glance which provider to start a long run on.

A background service keeps polling while the window is closed, so the tray icon and the notifications stay current. Native GTK4 + libadwaita — no Electron, no embedded browser.

• Every window. Five-hour, weekly, monthly — whatever the provider exposes, each with its own reset time.
• Several accounts per provider. A work and a personal Claude, two Z.ai keys — grouped behind an expand toggle.
• A pace mark on every bar. Fill to the left of the mark means the quota likely lasts until the reset; fill to the right means it does not.
• Warnings at 70% and 90%, plus a notification when a window resets. Off by default, switched on per window so you only hear about the ones you care about.
• History and a burn-down chart. Click a card to see how the current window was spent.
• Lives in the tray. Closing the window hides it; readings keep arriving.

Installation

Ubuntu/Fedora

Download the .deb or .rpm from the latest release:

Arch Linux

Install from AUR with yay/paru

yay -S tidemark-git

Nix

Install Tidemark directly from this repository:

nix profile install github:zbndev/tidemark

Or run the window without installing it:

nix run github:zbndev/tidemark

For NixOS, add Tidemark as a flake input, import its module, and enable the service:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    tidemark.url = "github:zbndev/tidemark";
  };

  outputs = { nixpkgs, tidemark, ... }: {
    nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        tidemark.nixosModules.default
        { services.tidemark.enable = true; }
      ];
    };
  };
}

The module installs Tidemark and registers its D-Bus-activated user daemon. It does not start the GTK window at login. nix run github:zbndev/tidemark#tidemarkd is available for diagnostics, but normal use should let D-Bus activate the daemon when the window or another client asks for it.

Getting started

Open Tidemark. With nothing configured yet it says Add a provider to start tracking your quota.

1. Open provider settings and press +.
2. Pick your provider from the searchable list.
3. Sign in, or paste an API key — the detail page says where to find it.

Keys are stored in your desktop keyring, never in a config file. Claude, Codex and Antigravity can sign in through Tidemark, or reuse the login their own CLI already has.

Removing a provider deletes its credentials and its card but keeps the quota history.

Reporting a wrong reading

If a card shows a number the provider's own dashboard disagrees with, the useful evidence is the response Tidemark actually received. Put this in ~/.config/tidemark/config.toml:

[debug]
raw_responses = true

then systemctl --user restart tidemarkd. Every provider response is written verbatim, one JSON object per line, to ~/.local/share/tidemark/debug/responses.ndjson:

jq 'select(.provider == "opencodego")' ~/.local/share/tidemark/debug/responses.ndjson

API keys are never written: request headers are left out entirely, URL query strings are redacted, and the sign-in endpoints are not logged at all. The file still describes your account's usage, so read it before attaching it to an issue. It rolls over at 16 MB and keeps one previous file. There is no switch in the interface — turning it off is the same edit, and a restart.

Supported providers

Sign in with your account

Antigravity · Claude · Codex

Paste an API key

ai& · Alibaba Coding Plan · Amp · Chutes · ClawRouter · ClinePass · Codebuff · Crof · Deepgram · DeepInfra · DeepSeek · ElevenLabs · Factory · Fireworks · Groq · IBM Bob · Kilo · Kimi · LiteLLM · LLM Proxy · MiniMax · Moonshot · NanoGPT · Neuralwatt · OpenAI · OpenCode Go · OpenRouter · Poe · StepFun · sub2api · Synthetic · Venice · Warp · xAI · Z.ai · ZenMux

Local session

Abacus · Augment · CommandCode · Cursor · Gemini · Grok · LongCat · Manus · MiMo · Mistral · Notion · Ollama · OpenCode · Perplexity · Qoder · Sakana · T3 Chat · ZoomMate

No credential needed

Wayfinder

Some providers need one extra setting alongside the key — a region, an account id, or the base URL of your own deployment. The provider's page asks for it.

Requirements

GTK 4.22 and libadwaita 1.9, which means Fedora 44+ or Ubuntu 26.04 LTS+ and their derivatives. Older distributions cannot run it. Arch and other rolling releases are fine.

Building from source

Needs Rust 1.92 or newer and the development packages for GTK4, libadwaita and SQLite:

git clone https://github.com/zbndev/tidemark.git

cargo build --workspace

cargo run -p tidemark

tidemarkd does the polling and tidemark is the window. The window never talks to a provider itself — it only shows what the daemon publishes on D-Bus, which also makes the daemon usable from busctl or a Waybar module. See CONTEXT.md for the architecture and the design record.

License

MIT — see LICENSE.

The provider marks under data/icons are their owners' trademarks and are not covered by this licence; see docs/TRADEMARKS.md, which also explains how to build without them.

Provider protocol details are taken from CodexBar (MIT).