pio-account
Manage PlatformIO user account
TLDR
Register a new PlatformIO account
Permanently delete your PlatformIO account and related data
Log in to your PlatformIO account
Log out of your PlatformIO account
Update your PlatformIO profile
Show detailed information about your PlatformIO account
Reset your password using your username or email
SYNOPSIS
pio account
PARAMETERS
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'.
DESCRIPTION
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.
CAVEATS
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.
TOKEN MANAGEMENT
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
SECURITY CONSIDERATIONS
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.
HISTORY
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.
SEE ALSO
pio(1)