Organizations & Account Status

The Optibot CLI always acts as exactly one organization at a time. Your review quota, repositories, API keys, and security scans all belong to that active organization. If you belong to more than one organization, the CLI gives you commands to see which one is active and to switch between them.

How the Active Organization Works

When you authenticate, Optibot issues a token that is scoped to a single organization. The active organization is encoded in that token, not stored separately on disk. Switching organizations means exchanging your current token for a new one scoped to the organization you pick.

A few consequences worth knowing:

• API keys are bound to the organization that was active when you created them. A key minted for one organization will not act on another. To create a key for a different organization, switch first, then create the key.
• Switching is instant and does not require a new browser login. The CLI re-scopes your existing session.
• During optibot login, if you belong to more than one organization, the CLI shows an arrow-key picker so you can choose which one to start in.

Checking Your Status

Run optibot status to see how you are authenticated, which organization is active, and how much of your review quota remains:

optibot status

The output includes:

• Auth method — whether the CLI is using the OPTIBOT_API_KEY environment variable or your saved config file.
• Org — the active organization (and your role in it). If you belong to more than one, it reminds you that optibot org switch can change it.
• Reviews — quota used, limit, and remaining, plus when the quota resets.
• A nudge to run optibot setup ci if you have no API keys yet and are wiring Optibot into CI.

Listing Your Organizations

optibot org list

Lists every organization you belong to. The active one is marked with a *, and your role in each is shown in parentheses.

Showing the Active Organization

optibot org current

Prints just the currently active organization and your role in it.

Switching Organizations

optibot org switch

Opens an interactive arrow-key picker of your organizations. Selecting a different one re-scopes your stored session to that organization. If you only belong to one organization, there is nothing to switch and the command says so.

Heads up: API keys are bound to the organization active at the time they were created. After switching, run optibot setup ci (or optibot apikey create <name>) if you need a key that acts as the newly selected organization.

optibot org switch requires an interactive terminal. In a non-interactive environment (such as CI), set the correct organization on a dev machine first and use the API key it produces.

Command Reference