[CLI] Add hf auth token command (#4104)

* [CLI] Add `hf auth token` command to print current token

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add hint about `hf auth whoami` after printing token

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* update test

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Wauplin

docs/source/en/package_reference/cli.md

@@ -67,6 +67,7 @@ $ hf auth [OPTIONS] COMMAND [ARGS]...
 * `login`: Login using a token from...
 * `logout`: Logout from a specific token.
 * `switch`: Switch between access tokens.
+* `token`: Print the current access token to stdout.
 * `whoami`: Find out which huggingface.co account you...
 
 ### `hf auth list`
@@ -168,6 +169,29 @@ Learn more
   Read the documentation at https://huggingface.co/docs/huggingface_hub/en/guides/cli
 
 
+### `hf auth token`
+
+Print the current access token to stdout.
+
+**Usage**:
+
+```console
+$ hf auth token [OPTIONS]
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+Examples
+  $ hf auth token
+  $ hf auth token | xargs curl -H 'Authorization: Bearer {}'
+
+Learn more
+  Use `hf <command> --help` for more information about a command.
+  Read the documentation at https://huggingface.co/docs/huggingface_hub/en/guides/cli
+
+
 ### `hf auth whoami`
 
 Find out which huggingface.co account you are logged in as.

src/huggingface_hub/cli/auth.py

@@ -148,6 +148,17 @@ def auth_list_cmd() -> None:
     auth_list()
 
 
+@auth_cli.command("token", examples=["hf auth token", "hf auth token | xargs curl -H 'Authorization: Bearer {}'"])
+def auth_token() -> None:
+    """Print the current access token to stdout."""
+    token = get_token()
+    if token is None:
+        out.error("Not logged in. Run `hf auth login` first.")
+        raise typer.Exit(code=1)
+    print(token)
+    out.hint("Run `hf auth whoami` to see which account this token belongs to.")
+
+
 @auth_cli.command("whoami", examples=["hf auth whoami", "hf auth whoami --format json"])
 def auth_whoami(
     format: FormatWithAutoOpt = OutputFormatWithAuto.auto,

tests/test_cli.py

@@ -32,6 +32,7 @@
 )
 from huggingface_hub.utils._verification import FolderVerification
 
+from .testing_constants import TOKEN
 from .testing_utils import DUMMY_MODEL_ID, with_production_testing
 
 
@@ -1658,6 +1659,22 @@ def test_whoami_not_logged_in_json(self, runner: CliRunner) -> None:
         assert "Not logged in" in result.output
 
 
+class TestAuthTokenCommand:
+    def test_token_prints_to_stdout(self, runner: CliRunner) -> None:
+        with patch("huggingface_hub.cli.auth.get_token", return_value=TOKEN):
+            result = runner.invoke(app, ["auth", "token"])
+        assert result.exit_code == 0
+        assert result.stdout.strip() == TOKEN
+        assert "hf auth whoami" in result.output
+
+    def test_token_not_logged_in(self, runner: CliRunner) -> None:
+        with patch("huggingface_hub.cli.auth.get_token", return_value=None):
+            result = runner.invoke(app, ["auth", "token"])
+        assert result.exit_code == 1
+        assert "Not logged in" in result.output
+        assert "hf auth login" in result.output
+
+
 class TestModelsLsCommand:
     def test_models_ls_basic(self, runner: CliRunner) -> None:
         repo = ModelInfo(