Log in to ChatGPT and refresh the tokens

[onechat] / README.rst

diff --git a/README.rst b/README.rst
index 362eeebd7d3d807a38dbeb2ce08d50a02e7569f1..fdcc0e0af17f1c70de0795242da868f4a67fe2e9 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -45,6 +45,24 @@ field is an error.
    The model and the reasoning effort of the summaries. The defaults are
    ``gpt-6-luna`` and ``high``.
 
+*******
+ Login
+*******
+
+The ``chatgpt`` endpoint needs a login with a ChatGPT account:
+
+.. code:: console
+
+   onechat login
+
+The command shows a link and a code. Open the link on any device, enter
+the code, and approve the login. Device code login must be allowed in
+the ChatGPT security settings. OneChat writes the tokens to
+``auth.json`` in the data directory, with mode 0600, and refreshes them
+before they expire. The file belongs to OneChat only. Do not share it
+with the Codex CLI, because each program rotates the refresh token and
+logs the other out.
+
 *************
  Development
 *************