oqoqo whoami run without a sign-in, and only whoami has a Plugin (MCP) tool. API keys and background updates are on the CLI reference.
oqoqo login
Sign in to Oqoqo with your browser.
Also takes the global flags.
Examples
Sign in on this computer, or from a remote machine by opening the printed link on any computer:
--quiet, and in a terminal it also opens the link in your browser. When you confirm the code in the browser, the command finishes, saves your sign-in, and makes your organization the active one. The result names you, your organization, and the dashboard URL.
While OQOQO_API_KEY is set, oqoqo login refuses to sign in and exits with code 2. Unset the variable first, as Use an API key explains.
oqoqo whoami
Show who the CLI acts as, in which organization, and whether it uses a sign-in or an API key.get_identity
Takes only the global flags.
Examples
Notes
To keep a script in one organization, pass
organization.id to --expected-organization-id on later commands: they then fail if your sign-in moves to another organization. When you’re not signed in, the command exits with code 3 and tells you to run oqoqo login.
oqoqo logout
Remove your saved sign-in and your saved project from this computer.OQOQO_API_KEY is set, commands keep using the key after you log out, and the CLI says so on stderr.
oqoqo version
Show the installed version, its release channel, the platform, and whether background updates are on.
Notes
oqoqo --version prints the version and channel on one line. Neither command contacts Oqoqo.
oqoqo upgrade
Replace the installedoqoqo binary with the latest release for its channel.
Also takes the global flags.
Examples
See whether a newer release exists, then install it:
Notes
The command doesn’t contact the Oqoqo API, so it still runs when other commands fail with
client_update_required. Use it when you don’t want to wait for a background update.
If the CLI can’t write its binary, the command tells you to reinstall in a folder you can write, such as ~/.local/bin or ~/.oqoqo/bin. You don’t need sudo.
oqoqo schema
Print machine-readable command definitions as JSON Schema.
Takes only the global flags.
Examples
List every command, then read the launch plan schema before you write a plan:
Notes
An unknown command name fails with
usage_error. The command doesn’t contact Oqoqo.
Related
oqoqo projects
List projects and choose the one later commands use.
CLI reference
Global flags, output, exit codes, and conventions.
Profile and API keys
Create a personal API key for CI jobs and other places where nobody can sign in.

