Skip to main content
The Moneda CLI uses OAuth 2.0 to securely connect to your account. Your credentials are never stored in plain text — the CLI saves an encrypted token on your machine.

​
Logging in

Run the login command to authenticate: 
moneda auth login
This opens your default browser where you sign in to your Moneda account and approve the requested permissions. Once approved, the CLI stores your token locally and you’re ready to use any command.
Your password is never shared with the CLI. The OAuth flow means the CLI only receives a scoped access token, not your credentials.

​
Checking your session

To see if you’re currently logged in and which account is active: 
moneda auth status
This shows your username, email, and when your token expires.

​
Logging out

To clear your stored credentials: 
moneda auth logout
This removes the saved token from your machine. You’ll need to run moneda auth login again to use the CLI.

​
Token storage

The CLI stores your OAuth token in: 
~/.moneda/auth.json
This file contains your access token. Keep it secure and don’t share it. If you suspect your token has been compromised, run moneda auth logout immediately to revoke it.

​
What’s next?

Command Reference

See all available CLI commands.

CLI Examples

Common workflows using the CLI.

Scopes

Understand what permissions the CLI requests.

REST API Authentication

How authentication works at the API level.