<!-- AUTO-GENERATED by scripts/generate-cli-docs.ts — do not edit. Regenerate: yarn docs:gen -->

# pop user

User & membership

## pop user register

Register a username on the account registry

```text
pop user register [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--username` | string | yes | - | Username (3-32 chars, alphanumeric + underscores) |

## pop user join

Join an organization (registers your username first if needed)

```text
pop user join [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--idempotency-key` | string | no | - | Explicit idempotency key. Two joins for the same org within the TTL return the same result without re-submitting. Default: auto-derived from argv. |
| `--no-idempotency` | boolean | no | `false` | Bypass the idempotency cache and always submit. |
| `--username` | string | no | - | Username to register (only needed if not already registered) |

## pop user whoami

Show signer identity: address, username, gas balance, and org standing

```text
pop user whoami [flags]
```

## pop user profile

View user profile

```text
pop user profile [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--address` | string | no | - | User address (defaults to signer) |

## pop user update-profile

Update profile (bio, avatar, links) or change your username

```text
pop user update-profile [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--avatar` | string | no | - | Avatar IPFS CID (Qm...) |
| `--bio` | string | no | - | Profile bio (max 280 chars) |
| `--github` | string | no | - | GitHub username |
| `--twitter` | string | no | - | Twitter/X handle |
| `--username` | string | no | - | New username (DESTRUCTIVE: releases the old name for anyone to claim) |
| `--website` | string | no | - | Website URL |

_Global flags: --org, --chain, --rpc, --json, --address, --private-key, --dry-run, --yes, --verbose, --quiet, --preflight (see [index.md](index.md))_
