# Nia Agent Onboarding

Set up Nia from any AI coding agent — no browser, no password. Your agent creates your account, verifies your email, and installs everything programmatically.

## Quick Start

Paste this prompt into Claude Code, Cursor, Windsurf, or any AI coding agent:

```
You are an agent that is going to onboard me to Nia by Nozomio Labs. Please run `npx nia-wizard@latest agent-guide` to get the instructions, then create my account using the passwordless signup API, ask me for the email verification code, verify my account, install the CLI, and set up skills. After you are done, output a summary including the credentials so I can store them securely.

Do not forget to first ask me which email and organization name I would like to use.
```

Your agent will handle everything — you just provide your email, org name, and a 6-digit code from your inbox.

## How It Works

### 1. Signup (no password)

```bash
curl -X POST https://apigcp.trynia.ai/v2/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "organization_name": "My Org", "first_name": "Jane", "last_name": "Doe"}'
```

Response:

```json
{
  "api_key": "nk_...",
  "api_key_id": "...",
  "user_id": "...",
  "organization_id": "...",
  "verified": false
}
```

The returned API key is **read-only** until verified. A 6-digit code is sent to your email.

### 2. Verify

```bash
curl -X POST https://apigcp.trynia.ai/v2/auth/verify \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer nk_..." \
  -d '{"code": "123456"}'
```

Response:

```json
{
  "verified": true
}
```

Your API key is now **full access** — index repos, search, query, everything.

### 3. Install CLI & Skills

```bash
npm install -g @nozomioai/nia@latest
nia auth login --api-key nk_...
nia skill --all
```

Done. Nia is ready.

## Returning Users

Already have an account? Log in without a password:

```bash
# Step 1: Request a code
curl -X POST https://apigcp.trynia.ai/v2/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# Step 2: Verify and get a new API key
curl -X POST https://apigcp.trynia.ai/v2/auth/login/verify \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "code": "123456"}'
```

## Resend Code

If you didn't receive the verification email:

```bash
curl -X POST https://apigcp.trynia.ai/v2/auth/resend-code \
  -H "Authorization: Bearer nk_..."
```

## API Reference

| Endpoint | Method | Auth | Description |
| --- | --- | --- | --- |
| /v2/auth/signup | POST | None | Create account, get read-only key |
| /v2/auth/verify | POST | Bearer nk_... | Verify email, upgrade to full access |
| /v2/auth/login | POST | None | Send login code to email |
| /v2/auth/login/verify | POST | None | Verify code, get full-access key |
| /v2/auth/resend-code | POST | Bearer nk_... | Resend verification code |

## Permission Model

| State | Can Search | Can Index | Can Delete |
| --- | --- | --- | --- |
| Unverified (read-only) | Yes | No | No |
| Verified (full access) | Yes | Yes | Yes |

## Rate Limits

- Signup: 5 per IP/min, 3 per email/min
- Login: 20 per IP/min, 5 per email/min
- Verify: 20 per IP/min, max 10 attempts per code
- Resend: 3 per key per 10 min
- Verification codes expire after 15 minutes

## Links

- App: [app.trynia.ai](https://app.trynia.ai)
- Docs: [docs.trynia.ai](https://docs.trynia.ai)
- API Reference: [docs.trynia.ai/api-reference](https://docs.trynia.ai/api-reference)
- Pricing: [trynia.ai/pricing.md](https://trynia.ai/pricing.md)
- Status: [status.trynia.ai](https://status.trynia.ai)
- Contact: [founders@nozomio.com](mailto:founders@nozomio.com)