`npx convex account`

Manage saved accounts and their directory selections.

Save logins for multiple Convex accounts under names such as work and personal. npx convex@latest account login and npx convex@latest account logout are aliases for the top-level login and logout commands, with the same options. Select the appropriate account for each personal, work, or client project.

In your personal project directory, save an account:

npx convex@latest login --account personal --select

In your work project directory, log in with your work account and check its teams:

npx convex@latest login --account work --select
npx convex@latest login status

Choose the appropriate account in the browser; sign out of the dashboard first if it is using another account. Upgrade each project's convex dependency to a version that supports saved accounts, then run npx convex dev to develop with its selected account.

login --account saves credentials without changing directory selections. Add --select to select the account for this directory and its subdirectories after checking deployment access. The first saved account becomes the default if no other account is saved. To select a saved account in another directory, run npx convex@latest account select work. Run npx convex@latest account deselect to remove this directory's selection and inherit its parent or default. Run npx convex@latest account default to show the default, or npx convex@latest account default work to change it. The closest directory selection wins. Selections use absolute paths, so select the account again after moving a project.

The first account name is assigned to your existing login if you are already logged in, and becomes the default for directories without a selection. Use --force to authenticate another account instead, keeping the existing login as the default. Names start with a lowercase letter or number and contain only lowercase letters, numbers, hyphens, and underscores.

CONVEX_ACCOUNT in the shell or project env file overrides directory selections and the default account. Deployment and project keys take priority over saved accounts.

Use npx convex@latest logout --account work to remove one account's credentials, or npx convex@latest logout --all to remove all saved credentials. Logout preserves directory selections; a logged-out account requires login before use.

After saving accounts, use npx convex@latest for login, logout, and account commands in every project directory on this machine. Plain npx convex can run the older version installed in that project. Specifying @latest runs the latest published CLI without updating the project's dependency.

Older CLIs ignore directory selections and CONVEX_ACCOUNT, using the shared login instead (normally the default account). Upgrade the project's convex dependency to use saved accounts with project commands such as npx convex dev and npx convex deploy.

Logging in with an older CLI can change the shared login independently of your saved accounts, or discard account settings if the shared login has been removed. Logging out with an older CLI deletes directory selections and the default selection but leaves named account credentials behind. Recreate any lost selections with npx convex@latest account select <name> and npx convex@latest account default <name>.

Syntax

npx convex account [options] [command]

Subcommands

npx convex account list — List saved accounts, credential status, and directory selections
npx convex account select — Use a saved account in this directory and its subdirectories
npx convex account default — Show or set the default account for directories without a directory selection
npx convex account deselect — Clear this directory's account selection, inheriting its parent's selection or the default
npx convex account login — Login to Convex
npx convex account logout — Log out of the selected account. Directory selections are preserved.