diff --git a/README.md b/README.md
index 3617ce1..ac54f53 100644
--- a/README.md
+++ b/README.md
@@ -112,6 +112,9 @@ putio auth login --profile devs-fe-auto
 putio auth profiles use devs-fe-auto
 ```
 
+The CLI does not accept put.io account credentials. Its login flow delegates authorization to the
+configured web app (`app.put.io` by default) and stores only the returned OAuth token.
+
 Check the auth source:
 
 ```bash
diff --git a/skills/putio-cli/references/auth.md b/skills/putio-cli/references/auth.md
index 18c5e30..ba579b1 100644
--- a/skills/putio-cli/references/auth.md
+++ b/skills/putio-cli/references/auth.md
@@ -15,6 +15,7 @@ putio auth status --output json
 For a stable agent or test-harness session:
 
 ```bash
+putio auth status --profile devs-fe-auto --output json
 putio auth login --profile devs-fe-auto
 putio auth profiles use devs-fe-auto
 ```