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

# pop CLI Reference

Command reference generated from the yargs command tree. Regenerate with `yarn docs:gen`; CI verifies it with `yarn docs:check`.

| Domain | Description | Commands | Reference |
| --- | --- | --- | --- |
| `task` | Task management | 17 | [task.md](task.md) |
| `project` | Project management | 4 | [project.md](project.md) |
| `org` | Organization management | 32 | [org.md](org.md) |
| `vote` | Governance & voting | 11 | [vote.md](vote.md) |
| `user` | User & membership | 5 | [user.md](user.md) |
| `education` | Education modules | 5 | [education.md](education.md) |
| `vouch` | Vouching system | 9 | [vouch.md](vouch.md) |
| `token` | Participation token requests | 5 | [token.md](token.md) |
| `treasury` | Treasury & distributions | 14 | [treasury.md](treasury.md) |
| `paymaster` | Gas sponsorship (ERC-4337) | 3 | [paymaster.md](paymaster.md) |
| `role` | Authority roles and membership | 27 | [role.md](role.md) |
| `group` | Authority groups | 5 | [group.md](group.md) |
| `zkemail` | ZK Email role invites (allowlists) | 6 | [zkemail.md](zkemail.md) |
| `config` | View and validate configuration | 2 | [config.md](config.md) |
| `mcp` | Serve the CLI as an MCP server for AI integrations | 1 | [mcp.md](mcp.md) |

## Top-level commands

Run directly as `pop <command>` (not under a domain):

## pop init

Interactive setup: wallet, chain, default org, .env

```text
pop init [flags]
```

| Flag | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `--chain` | number | no | - | Chain ID to configure (100 Gnosis, 42161 Arbitrum, 11155111 Sepolia, 84532 Base Sepolia) |
| `--file` | string | no | - | Write to this exact path (testing) |
| `--force` | boolean | no | `false` | Overwrite an existing target .env file |
| `--generate-key` | boolean | no | `false` | Generate a fresh wallet non-interactively (prints the mnemonic once) |
| `--global` | boolean | no | `false` | Write ~/.pop/.env (per-user) instead of ./.env (project-local) |
| `--org` | string | no | - | Default org name or hex ID (POP_DEFAULT_ORG) |


## Global flags

Available on every command:

- `--org` — Organization ID or name (or set POP_DEFAULT_ORG) (string)
- `--chain` — Chain ID override (number)
- `--rpc` — RPC URL override (string)
- `--json` — Output JSON for machine consumption (boolean, default: false)
- `--address` — Observe as this address for identity-scoped reads (or set POP_ADDRESS) — no key needed (string)
- `--private-key` — Private key (hex) (string)
- `--dry-run` — Simulate without sending transactions (boolean, default: false)
- `--yes`, `-y` — Skip confirmations (boolean, default: false)
- `--verbose`, `-v` — Debug output (boolean, default: false)
- `--quiet`, `-q` — Suppress non-essential output (boolean, default: false)
- `--preflight` — Run pre-flight checks before writes (--no-preflight to skip) (boolean, default: true)