pio-account

Register a new PlatformIO account

$ pio account register [[-u|--username]] [username] [[-e|--email]] [email] [[-p|--password]] [password] --firstname [firstname] --lastname [lastname]

$ pio account destroy

$ pio account login [[-u|--username]] [username] [[-p|--password]] [password]

$ pio account logout

$ pio account update [[-u|--username]] [username] [[-e|--email]] [email] --firstname [firstname] --lastname [lastname] --current-password [password]

$ pio account show

$ pio account forgot [[-u|--username]] [username_or_email]

pio account [options]

login
    Log in to your PlatformIO account. This requires your username (email) and password.

logout
    Log out of your current PlatformIO account.

show
    Show the current account information, including username, email, and API token(s).

token
    Manage API tokens for your account. Subcommands include 'create' and 'delete'.

The `pio account` command provides a command-line interface (CLI) for managing your PlatformIO account. This includes viewing account details, logging in, logging out, and managing your account's API tokens. It streamlines interacting with the PlatformIO ecosystem directly from your terminal, enabling automated tasks and integrations with development workflows. This avoids the need to manually manage account settings through the PlatformIO IDE or web interface. It's particularly useful for Continuous Integration (CI) environments and scripting. The command helps facilitate tasks like device management, remote compilation, and interaction with PlatformIO's services without relying on a graphical user interface.

Requires a PlatformIO account. API tokens should be handled with care as they grant access to your account. Ensure the security of your API tokens and avoid committing them to public repositories.

The 'token' subcommand allows users to create and delete API tokens associated with their PlatformIO account.
These tokens are essential for automating tasks that require authentication with PlatformIO services, such as uploading projects or retrieving library information programmatically.
Usage: `pio account token create` to create a new token and `pio account token delete ` to delete a specific token.

Always store and handle API tokens securely.
Treat them like passwords and avoid committing them directly to version control systems or sharing them publicly.
Consider using environment variables or secure configuration files to manage tokens in your development environment.

The `pio account` command was developed as part of the PlatformIO ecosystem to provide a more flexible and scriptable way to interact with the PlatformIO cloud services.
Its introduction aimed to simplify account management for users who prefer working from the command line or need to integrate PlatformIO into automated workflows.
Over time, the command has been extended with new subcommands and options to support more advanced account management features.

pio(1)