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

# percio login

> Store your API key on disk

Save your API key so the CLI and MCP server can use it automatically.

## Synopsis

```bash theme={null}
percio login
```

You'll be prompted to paste your API key. Paste it and press enter.

## What it does

* Stores the key at `~/.config/percio/credentials.json`.
* Makes the key available to every future `percio` and `percio-mcp` invocation on this machine.

## Example

```bash theme={null}
$ percio login
Paste your API key: pk_••••••••••••••••••••••••••••
Validating key...
API key saved to ~/.config/percio/credentials.json
You're all set! Run: percio test --url <url> --flow <task>
```

## When to use this

* First time you install the CLI on a machine.
* After rotating your API key on the dashboard.

## When *not* to use this

* In CI — prefer the `PERCIO_API_KEY` environment variable so nothing writes to disk.
* On shared machines where you don't want your key persisted for other users of your account.

See [Authenticate](/agent/authentication) for the full comparison.

## Where the key is stored

```
~/.config/percio/credentials.json
```

Delete this file to log out. `PERCIO_API_KEY` (if set) takes precedence over whatever is in the file.

## What's next

* [percio test](/agent/cli/test)
* [percio personas list](/agent/cli/personas-list)