[CLI] Add hf auth token command

[Wauplin]

(related to internal private slack thread)

Adds hf auth token to print the current token to stdout. Handy for piping into other commands.

$ hf auth token
hf_xxx***
Hint: Run `hf auth whoami` to see which account this token belongs to.

You can pipe this output to make a cURL call

$ hf auth token | xargs -I {} curl -H "Authorization: Bearer {}" https://huggingface.co/api/settings/billing/usage

If not logged in, prints an error nudging to hf auth login and exits 1.

$ hf auth token
Error: Not logged in. Run `hf auth login` first.

🤖 Generated with Claude Code

---

Note: the plan in a future PR is to provide a hf api command similar to gh api to make authenticated calls to any endpoint on hf.co/ (would need a maybe a hf api schema to fetch https://huggingface.co/spaces/huggingface/openapi + hf api run ?). In any case, hf auth token will still be useful for instance to do export ANTHROPIC_AUTH_TOKEN="$(hf auth token)" in hf-claude cc @hanouticelina

[bot-ci-comment]

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

[Wauplin]

I left print since we want to print only the token, no matter the output mode

[hanouticelina]

Looks good!

[julien-c]

nice 👍

[huggingface-hub-bot]

This PR has been shipped as part of the v1.11.0 release.