Skip to content

Describe the tool that exists, and finish the table it needed - #26

Merged
naturalmoods merged 1 commit into
mainfrom
issue-12-docs-refresh
Aug 18, 2026
Merged

naturalmoods merged 1 commit into
mainfrom
issue-12-docs-refresh

Conversation

@naturalmoods

Copy link
Copy Markdown
Owner

Closes #12.

The README showed five providers and the pre-collapse table. Nineteen providers later, the stalest parts were the first things anyone reads.

README

  • The example output is generated by the renderer, not typed — so the layout cannot drift from what the binary prints. The figures are representative and the README says so.
  • A provider table, and it is the honest summary of the state of LLM billing APIs: 5 publish a balance endpoint worth trusting, 3 answer one whose shape had to be inferred, 11 publish nothing at all. That column is why confidence exists.
  • --all is documented in ## Use.

A test pins the table to the registry. A provider list that slowly stops matching the binary is the likeliest documentation rot in this repo — nothing else in the README can go stale just because someone added a YAML file. Verified by renaming a row to anthropik: caught in both directions (missing from the table, and named but not in the registry).

Three table changes, finishing work deferred earlier

change why now
both closing lines wrap at word boundaries nineteen ids is 200+ characters, broken mid-id by whatever the terminal's width happens to be
the balance column is sized with the totals 130.16 USD against 18.42 USD: the totals block hung one character past the rule above it
trailing spaces trimmed from rows a row with an empty note ended in the column separator

The wrapping was deliberately deferred twice (#14, #17) on the grounds that it applies to outside the verified total: as well, and one habit is better than two — so both lines go through the same helper. The test asserts no closing line exceeds 82 runes and that nothing was dropped in the process, which is the half that matters.

config.example.yaml

Grouped by what a provider can do rather than by which five happened to exist first, and it now documents as_of: and disabled:.

go test -race ./..., go vet ./..., gofmt -l . and go mod tidy -diff clean.

What is left for #13

Everything on the release checklist except the tag itself. Cutting it is yours: it wants aipocket version checked on a real artifact and on a fresh go install …@latest, which is not something I should do on your behalf.

🤖 Generated with Claude Code

The README still showed five providers and the pre-collapse table. Nineteen
providers later, the parts that had gone stale were the first things anyone reads.

The example output is generated by the renderer itself rather than typed, so the
layout cannot drift from what the binary prints; the figures are representative and
the README says so. It now shows what a real run looks like: documented balances,
an inferred one, rows for providers that publish nothing, and eleven unconfigured
providers folded into one line.

The provider table is the honest summary of the state of LLM billing APIs, and it
is why a column called `confidence` exists: five providers publish a balance
endpoint worth trusting, three answer one whose shape had to be inferred, and
eleven publish nothing at all. A test asserts the table and the registry name the
same set, because a provider list that slowly stops matching the binary is the
likeliest documentation rot here — nothing else in the README can go stale by
someone adding a YAML file.

Three table changes finish work deferred from earlier rounds:

Both closing lines now wrap at word boundaries. Nineteen ids on one line is over
two hundred characters, which a terminal breaks mid-id at whatever column it
happens to be. This was deliberately deferred twice, on the grounds that it applies
to `outside the verified total:` as well and one habit is better than two — so both
go through the same helper.

The balance column is sized with the totals included. As soon as several providers
report, the total is wider than any single row (130.16 USD against 18.42 USD) and
the totals block hung one character past the rule above it.

Trailing spaces are trimmed from each row. A row whose note is empty ended in the
column separator, which shows up in every diff of captured output.

config.example.yaml is grouped by what a provider can do rather than by which five
happened to exist first, and documents `as_of:` and `disabled:`.

Fixes #12

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@naturalmoods
naturalmoods merged commit 0734c0f into main Aug 18, 2026
5 checks passed
@naturalmoods
naturalmoods deleted the issue-12-docs-refresh branch August 18, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refresh README and CLAUDE.md for the grown registry

1 participant