---
title: "ollama-usage, enhanced"
description: "Per-model usage breakdowns, richer JSON, and more ways to feed it cookies — an update to the ollama-usage CLI."
pubDatetime: 2026-05-27T08:00:00Z
author: hrbrmstr
tags: ["tool", "go", "cli", "ollama"]
---
> Original: [ollama-usage, enhanced](https://ai.rud.is/posts/2026-05-27-ollama-usage-enhanced)

Back in April I [wrote about](https://ai.rud.is/posts/2026-04-04-ollama-usage/) a tiny Go CLI,
[`ollama-usage`](https://git.sr.ht/~hrbrmstr/ollama-usage), that scrapes
Ollama Cloud usage data from the terminal so I don't have to squint at
their light-mode-only settings page at 0-dark-30.

Since then Ollama changed their HTML structure (of course they did), which
meant the old scraping logic broke. Rather than just duct-tape it, I took
the opportunity to make the tool a bit more useful.

## What's new

### Per-model breakdowns

Pass `-verbose` (or `-v`) and you now get request counts and percentages
broken out by model, for both the session and weekly windows:

```
ollama-usage -verbose
Ollama Cloud Usage (pro plan)

  Session:   24.6% used  (resets in 3 hours)
  Weekly:     6.6% used  (resets in 4 days)

  Session █████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  24.6%
  Weekly  ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   6.6%

Session models:
  deepseek-v4-pro                   53 requests  ( 18.6%)
  glm-5.1                           45 requests  (  5.6%)
  glm-5                              6 requests  (  0.2%)
  ...

Weekly models:
  deepseek-v4-pro                   86 requests  (  5.0%)
  glm-5.1                           58 requests  (  1.5%)
  ...
```

This is a feature I kind of wanted from the start — it's one thing to
know you're at 25% of your session quota, but it's another to know which
model is eating it.

### Richer JSON

The `-json` output now mirrors the same nested structure:

```json
{
  "plan": "pro",
  "session": {
    "percent": 24.6,
    "resets_at": "2026-05-27T15:00:00Z",
    "models": [
      {
        "model": "deepseek-v4-pro",
        "requests": 53,
        "percent": 18.6,
        "color": "#af52de"
      }
    ]
  },
  "weekly": {
    "percent": 6.6,
    "resets_at": "2026-06-01T00:00:00Z",
    "models": [
      {
        "model": "deepseek-v4-pro",
        "requests": 86,
        "percent": 5.0,
        "color": "#af52de"
      }
    ]
  },
  "fetched_at": "2026-05-27T10:15:00Z"
}
```

The `color` field is whatever Ollama uses in their own UI for that model's
bar — useful if you're piping this into a dashboard.

### More ways to authenticate

In addition to auto-extracting the Firefox cookie on macOS, you can now:

- Pass a raw cookie string with `-cookie`
- Read one from a file with `-cookie-file`
- Point at a specific Firefox `cookies.sqlite` with `-db`

All three are handy for CI, remote machines, or just not wanting to hunt
through `~/Library`.

## Still no API

Ollama still hasn't shipped an official usage endpoint (the
[feature request](https://github.com/ollama/ollama/issues/15132) is still
open), so we're still scraping. The good news is the new parser is more
robust — it walks the DOM rather than regexing raw HTML, so the next time
they move a div around it should be a one-line fix instead of a rewrite.

If you're already using `ollama-usage`, `git pull` and `go build` should
get you the new bits. If not, the repo is at
[`git.sr.ht/~hrbrmstr/ollama-usage`](https://git.sr.ht/~hrbrmstr/ollama-usage).

Kick the tyres, shoot me a PR, and maybe bug the Ollama folks about that API.


```json
[
  {
    "@context": "https://schema.org",
    "@type": "BlogPosting",
    "@id": "https://ai.rud.is/posts/2026-05-27-ollama-usage-enhanced",
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://ai.rud.is/posts/2026-05-27-ollama-usage-enhanced"
    },
    "headline": "ollama-usage, enhanced",
    "datePublished": "2026-05-27T08:00:00Z",
    "description": "Per-model usage breakdowns, richer JSON, and more ways to feed it cookies — an update to the ollama-usage CLI.",
    "url": "https://ai.rud.is/posts/2026-05-27-ollama-usage-enhanced",
    "keywords": [
      "tool",
      "go",
      "cli",
      "ollama"
    ],
    "author": [
      {
        "@type": "Person",
        "name": "hrbrmstr",
        "url": "https://rud.is"
      }
    ],
    "publisher": {
      "@type": "Organization",
      "name": "hrbrmstr",
      "url": "https://ai.rud.is/",
      "sameAs": [
        "https://mastodon.social/@hrbrmstr",
        "https://bsky.app/profile/hrbrmstr.bsky.social",
        "https://github.com/hrbrmstr",
        "https://sr.ht/~hrbrmstr"
      ]
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "item": {
          "@id": "https://ai.rud.is/",
          "name": "ai.rud.is"
        }
      },
      {
        "@type": "ListItem",
        "position": 2,
        "item": {
          "@id": "https://ai.rud.is/posts/2026-05-27-ollama-usage-enhanced",
          "name": "ollama-usage, enhanced"
        }
      }
    ]
  }
]
```