# npx zephex (recommended install)

`npx -y zephex@latest setup` auto-detects your editor, runs OAuth, creates an API key, and writes global MCP config (user-level paths). Always use `@latest` to avoid stale npx cache.

## Avoid-repeat checklist
1. `npx -y zephex@latest setup --cursor` (or your editor flag)
2. `npx -y zephex@latest doctor` + `list`
3. `npx -y zephex@latest repair` if doctor flags stdio
4. Fully quit editor (Cmd+Q), reopen
5. Do not re-run setup repeatedly — each run can mint a new API key

## Essential commands
- `setup` — connect editor(s), global by default
- `doctor` / `list` / `repair` — health and fix stdio pins
- `disconnect --cursor` — remove + revoke key
- `usage` — monthly quota

## Common flags
- `--cursor`, `--claude`, `--vscode`, `--antigravity`, `--opencode`, …
- `--api-key mcp_prod_…` — skip OAuth
- `--project` — opt-in workspace config (default is global)

## Why no curl | bash?
Zephex uses npx/npm — MCP setup writes editor JSON + browser OAuth, not a system daemon. No root, cross-platform.


Canonical HTML: https://zephex.dev/docs/npx-zephex