PlatformIO Auth Token command

docs/userguide/account/cmd_login.rst

@@ -27,7 +27,9 @@ Usage
 Description
 -----------
 
-Log in to :ref:`cmd_account`.
+Log in to :ref:`cmd_account`. If you are not able to provide authentication
+credentials manually you can use :envvar:`PLATFORMIO_AUTH_TOKEN`. This is
+very useful for :ref:`ci` systems and :ref:`pio_remote` operations .
 
 Options
 ~~~~~~~

docs/userguide/account/cmd_token.rst

@@ -0,0 +1,44 @@
+..  Copyright 2014-present PlatformIO <contact@platformio.org>
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+       http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+.. _cmd_account_token:
+
+platformio account token
+===========================
+
+.. contents::
+
+Usage
+-----
+
+.. code-block:: bash
+
+    platformio account token
+
+
+Description
+-----------
+
+Get or regenerate Personal Authentication Token. It is very useful for :ref:`ci`
+systems, :ref:`pio_remote` operations where you are not able manually authorize.
+
+PlatformIO handles Personal Authentication Token from environment variable
+:envvar:`PLATFORMIO_AUTH_TOKEN`.
+
+Options
+~~~~~~~
+
+.. program:: platformio account token
+
+.. option::
+    --regenerate
+
+    If this option is specified a new authentication token will be generated.

docs/userguide/account/index.rst

@@ -38,3 +38,4 @@ To print all available commands and options use:
     cmd_logout
     cmd_password
     cmd_register
+    cmd_token