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

# CLI

> Install the bisibility CLI, sign in with OAuth, and run rank checks from a terminal.

The bisibility CLI manages projects, tracked keywords, rank checks, alerts, and
other API resources from a terminal. Use `--json` when another program consumes
the output.

## Install

```bash theme={null}
npm install -g @bisibility/cli
bisibility --help
```

## Sign in

The hosted CLI login uses browser consent. It stores the resulting personal
access token locally, so the token does not need to be copied from the browser.

```bash theme={null}
bisibility auth login --name "mbp16-cli" --scope admin --expires 90
```

Choose the smallest scope needed for the work. See the
[personal access token guide](/docs/api/personal-access-tokens) for scopes, expiry,
storage, and revocation.

## Run a rank check

Select a project, add a keyword, and run its first check:

```bash theme={null}
bisibility config set projectId prj_a00000000000000000000000
bisibility keywords add "headless cms" --device desktop --country "United States"
bisibility check run kw_b00000000000000000000000 --json
```

The completed response includes the current and previous position:

```json theme={null}
{
  "position": 7,
  "previous_position": 10,
  "status": "completed"
}
```

Run `bisibility <command> --help` for command-specific options. Provider
credentials are connected during product onboarding and are not part of the CLI
first-run sequence.

## Related guides

* [API overview](/docs/api/overview)
* [SDKs](/docs/sdks/overview)
* [AI agents and MCP](/docs/agents)