Netlify Builds
Source Code: https://github.com/browniebroke/netlify-builds
A command line utility to check build usage across multiple Netlify accounts
Installation
Recommended to install this via uv:
uv tool install netlify-builds
Setup
Create a .netlify-builds.json in your home directory with the following shape:
{
"team-name-1": "access-token-1",
"team-name-2": "access-token-2",
...
}
To obtain the token for each team, open a private browsing session and login to your team dashboard and copy it from the local storage, it should be located under the key nf-session.
DO NOT LOG OUT. Instead, simply close the private browsing session. If you log out, the token will be invalidated.
Profit
You're good to go, check all your accounts from the comfort of your terminal:
➜ netlify-builds
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━┓
┃ Team ┃ Mins ┃ Start Date ┃ End Date ┃ Elapsed ┃ Used ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━┩
│ team-blue │ 5 mins │ 2020-11-16 │ 2020-12-16 │ 11.6% │ 1.7% │
│ team-red │ 182 mins │ 2020-10-27 │ 2020-11-27 │ 75.9% │ 60.7% │
│ team-green │ 46 mins │ 2020-11-02 │ 2020-12-02 │ 58.3% │ 15.3% │
└───────────────────┴──────────┴────────────┴────────────┴─────────┴───────┘
If you're likely to exceed the free quota (300 mins) the rows will appear in red, otherwise in green.
Contributors ✨
Thanks goes to these wonderful people (emoji key):
 Bruno Alla 💻 📖 🤔 |
This project follows the all-contributors specification. Contributions of any kind welcome!
Credits
This package was created with Cookiecutter and the browniebroke/cookiecutter-pypackage project template.
1 maintainer
Release files for netlify-builds 1.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| netlify_builds-1.5.0.tar.gz | 7.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| netlify_builds-1.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.5 kB
Release files / netlify_builds-1.5.0.tar.gz
| Download URL | netlify_builds-1.5.0.tar.gz |
|---|---|
| Size | 7.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
21ab483b5c3cc5bd3eb558d9d9675d7f61ea1885e7aa3732f5881337fb563ae9
|
|
BLAKE2b-256 checksum How to use checksums |
3293f98b1cbd263461e28fb068ead6df7645f39c30d8d10410ef48139007dc35
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 7, 2026.
Transparency logRelease files / netlify_builds-1.5.0-py3-none-any.whl
| Download URL | netlify_builds-1.5.0-py3-none-any.whl |
|---|---|
| Size | 6.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
341b2196dec2feabeecbf0ce4b413cd92f5b8486c2dd0771cd9dc7b012b1abe2
|
|
BLAKE2b-256 checksum How to use checksums |
1a08634e50e18da22b35344dc646ba97c89565edd9d3dc86a6320dc2e10dd03b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 7, 2026.
Transparency log
