Skip to main content
Save your API key so the CLI and MCP server can use it automatically.

​
Synopsis

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

$ 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 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