> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oqoqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> The oqoqo command-line client: install, sign in, and drive Oqoqo from your terminal, from agents, or from CI.

`oqoqo` is the command-line client for Oqoqo. It signs you in with your browser and talks to the Oqoqo API as you. It is built for both people and agents, so every command has a JSON output mode and stable exit codes.

## Install

```sh theme={null}
curl -fsSL https://beta.oqoqo.ai/install | sh
```

Update at any time:

```sh theme={null}
oqoqo upgrade          # install the latest release
oqoqo upgrade --check  # check for a newer release without installing
```

## Sign in

```sh theme={null}
oqoqo login    # opens your browser to sign in
oqoqo whoami   # show the signed-in identity
```

## Built for agents

Every command supports these, so agents and scripts can drive the CLI without parsing help text:

* `--output json` prints one JSON envelope on stdout, so automation can always parse the result.
* Exit codes are stable: `0` success, `2` usage error, `3` auth error, `4` API error, `5` network error.
* `oqoqo schema` prints machine-readable definitions of every command.

## Common commands

| Command         | What it does                               |
| --------------- | ------------------------------------------ |
| `oqoqo login`   | Sign in through your browser               |
| `oqoqo whoami`  | Show the signed-in identity                |
| `oqoqo version` | Show the installed version and channel     |
| `oqoqo upgrade` | Update to the latest release               |
| `oqoqo schema`  | Print machine-readable command definitions |

Run `oqoqo --help` for the full list.