Getting started

Sign up at the dashboard, create an Organization, and create your first App. The App's publicKey (starts with pub_) is what your widget uses to authenticate.

React:

pnpm add @userz-ai/react @userz-ai/browser

// In your app root:
import { UserzProvider } from '@userz-ai/react';

<UserzProvider publicKey="pub_...">
  <App />
</UserzProvider>

Vanilla JS (script tag):

<script src="https://cdn.userz.ai/v1/userz.js" async></script>
<script>
  window.addEventListener('load', () => {
    Userz.createUserz({ publicKey: 'pub_...' });
  });
</script>

On the Repos page, click "Connect GitHub repo", install the Userz GitHub App on the repository you want to receive PRs against. The App requests minimum permissions: contents:write + pull_requests:write only.

Settings → AI provider key. Paste a key from any supported provider — Anthropic, OpenAI, Moonshot (Kimi), or z.ai (GLM). You can pick different providers for the coding agent and for the in-line helpers (sanitization, context-building, summaries). Keys are encrypted at rest and used only at run time.

Submit some feedback through the widget. Within ~1-3 minutes you'll see a draft PR appear in your repo with the agent's summary, the changed files, and a warning banner asking you to verify before merging.

If the diff isn't quite right, leave inline comments and click Request revision — the agent re-runs and commits on top of the same branch. Iterate until you're happy.