The latest articles on DEV Community by Davi Castro (@davicjc). https://dev.to/davicjc https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4241915%2F7780a62f-d7f7-493d-af7f-ef14758f0fda.jpg https://dev.to/davicjc en Davi Castro Thu, 12 Nov 2026 23:37:36 +0000 https://dev.to/davicjc/i-kept-running-out-of-claude-code-quota-mid-task-so-i-put-the-limits-on-my-linux-panel-1472 https://dev.to/davicjc/i-kept-running-out-of-claude-code-quota-mid-task-so-i-put-the-limits-on-my-linux-panel-1472 <p>I use Claude Code, Antigravity (Gemini) and Copilot most of the day, and the way I usually found out I had hit a limit was a task stopping halfway through. Each tool shows its usage somewhere (<code>/usage</code> in Claude Code, a settings page elsewhere), but I never look until it's too late.</p> <p>So I made <strong>CotaBar</strong>, a small applet for the Cinnamon panel on Linux Mint. Each tool gets a double ring: the outer one is the long window (week or month), the inner one the short window (5 hours). Next to it are the two percentages with a letter for the period (H, D, W, M). Clicking it lists every limit with a bar and when it resets.</p> <p><a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhmrn48sclp04mdbwp7pg.png" class="article-body-image-wrapper"><img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhmrn48sclp04mdbwp7pg.png" alt="CotaBar on the panel with the menu open" width="465" height="636"></a></p> <h2> How it gets the numbers </h2> <p>A Python script, standard library only, runs every few minutes. It reads the login each tool already keeps on disk and asks the same usage endpoint the tool itself uses:</p> <ul> <li>Claude Code: <code>~/.claude/.credentials.json</code>, the endpoint behind <code>/usage</code> </li> <li>Antigravity: the <code>agy</code> CLI token, Cloud Code's quota summary</li> <li>Codex: <code>~/.codex/auth.json</code> </li> <li>Copilot: <code>gh auth token</code> </li> </ul> <p>Two rules I didn't want to break:</p> <ul> <li> <strong>Never refresh a token.</strong> Refreshing Claude's or Codex's token rotates it, which would log out the session I have open. If a token is expired, CotaBar keeps the last good reading. With an expired token the tool is idle, so usage can't have gone up; it only zeroes the windows whose reset time already passed.</li> <li> <strong>Never write a token.</strong> The applet only reads a JSON with percentages and reset times.</li> </ul> <p>A small thing I found along the way: Antigravity's quota endpoint returns only one model group unless the User-Agent carries the client version. With the version it returns Gemini, Claude/GPT and Argon separately.</p> <h2> Install </h2> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>git clone https://github.com/Davicjc/cotabar.git <span class="nb">cd</span> cotabar <span class="o">&amp;&amp;</span> ./instalar.sh </code></pre> </div> <p>It shows up on the panel without restarting Cinnamon. The menu also has an update button that pulls the latest version from GitHub.</p> <p>Codex support follows the official endpoint, but I couldn't test it with a real account yet. If you use Codex, I'd love to know whether it works. The idea came from <a href="https://github.com/vinzdg/codenotch" rel="noopener noreferrer">Codenotch</a>, a macOS app that puts these limits on a notch; CotaBar is a separate implementation for the Linux panel.</p> <p>Repo: <a href="https://github.com/Davicjc/cotabar" rel="noopener noreferrer">https://github.com/Davicjc/cotabar</a></p> linux opensource ai python