> ## 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 personas list

> List your cloud personas and their UUIDs

Print every persona on your account. Use it to find the UUIDs you need for `percio test --persona-id`.

## Synopsis

```bash theme={null}
percio personas list
```

## Options

| Flag                  | Description                             |
| --------------------- | --------------------------------------- |
| `-c, --config <path>` | Path to a `.perciorc.json` config file. |

## Example

```bash theme={null}
$ percio personas list

3 personas from Percio API:

  👨‍💻 Sam the first-timer — Freelance designer
    ID: 123e4567-e89b-12d3-a456-426614174000
    New to subscription tools
    Tech expertise: intermediate

  👩‍💼 Rachel the power user — Growth marketer
    ID: 223e4567-e89b-12d3-a456-426614174001
    Ships daily, expects keyboard shortcuts
    Tech expertise: expert

  📱 Maya on mobile — Cafe owner
    ID: 323e4567-e89b-12d3-a456-426614174002
    Shops from her phone while on break
    Tech expertise: beginner
```

Copy the `ID:` line for the persona you want to use with `--persona-id`.

## Using the output

```bash theme={null}
percio test --url https://example.com \
  --flow "Sign up" \
  --persona-id 123e4567-e89b-12d3-a456-426614174000
```

To evaluate the same flow through a different persona, run a second `percio test` command with that persona's UUID.

## Don't see the persona you want?

Create one:

* From the web app on the **Personas** page ([Creating personas](/personas/creating-personas)).
* From Cursor via the MCP tools `chat_persona` and `create_persona` ([MCP tools](/agent/mcp-tools/create-persona)).

## What's next

* [percio test](/agent/cli/test)
* [Persona strategy](/personas/strategy)