kyvvu register / login

What you'll learn: How to create an account, log in, check your session, and manage authentication.

---

kyvvu register

Create a new Kyvvu account. Prompts for email, display name, and password. On success, creates an API key and stores it locally.

Usage: kyvvu register [OPTIONS]

Options:
  --api-url TEXT  Kyvvu API URL (default: https://platform.kyvvu.com)

Example

$ kyvvu register
Registering at https://platform.kyvvu.com

Email: [e-mail]
Display name: Your Name
Password:
Confirm password:

✓ Account created and verified.

Your API key (save this — it will not be shown again):

    KvKey-abc123...

Set it in your environment:

    export KV_API_KEY=KvKey-abc123...

Next steps:
    kyvvu init my-agent

Verification and waitlisting

If the platform is at capacity, your account is created but waitlisted:

Kyvvu is in early access — we're actively managing growth.
Your account has been created and you're on the waitlist.
We'll contact you at [e-mail] when your account is ready.

If your organization requires admin approval, you'll see:

Your account at company.com is pending verification.
An admin at your organization needs to approve you before you can
create agents or API keys.
Once they've approved you, run `kyvvu login` to refresh your session.

kyvvu login

Log in to an existing account. Stores a JWT locally for dashboard and CLI operations.

Usage: kyvvu login [OPTIONS]

Options:
  --api-url TEXT  Kyvvu API URL

Example

$ kyvvu login
Email: [e-mail]
Password:

✓ Logged in as [e-mail]

If no API key is stored, you'll be offered to create one.

kyvvu logout

Clear the JWT session. Your API key in ~/.kyvvu/config.toml is preserved — agents continue to work.

$ kyvvu logout
✓ Logged out. Your API key in ~/.kyvvu/config.toml is preserved
(the SDK and agents continue to work).

kyvvu whoami

Show current user info, verification status, and endpoint configuration.

$ kyvvu whoami
Email:         [e-mail]
API URL:       https://platform.kyvvu.com
Verification:  ✓ verified
Log endpoint:  stdout
Incidents:     not configured

Configuration storage

Auth state is stored in ~/.kyvvu/config.toml:

• JWT token and expiry (cleared by kyvvu logout)

• Default API key (preserved across logins)

• API URL

---

Next steps

• kyvvu init — scaffold a new agent project

• Installation — full setup guide