> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmo.humanizing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Learn how to sign up, sign in, and manage your account access

## Overview

Cosmo by Humanizing provides secure authentication to protect your account and workspaces. You can sign in using email and password, a passwordless magic link, or try the platform anonymously.

## Sign Up

Create a new account to get started with Cosmo by Humanizing.

<Steps>
  <Step title="Navigate to Sign Up">
    Go to the **Sign Up** page or click "Sign up" from the sign-in page.
  </Step>

  <Step title="Enter Your Details">
    Fill in the registration form:

    * **Full Name** - Your display name in the platform
    * **Email** - A valid email address for verification
    * **Password** - At least 8 characters
    * **Confirm Password** - Re-enter your password to confirm
  </Step>

  <Step title="Create Your Account">
    Click **Sign Up** to create your account. You'll be redirected to a verification pending screen — check your email inbox for a verification link.
  </Step>

  <Step title="Verify Your Email">
    Click the verification link in your email to confirm your address. You will not be able to access the dashboard until your email is verified. If you don't see the email, check your spam folder or use the **Resend** button on the verification screen.
  </Step>
</Steps>

<Note>
  Your password must be at least 8 characters long. Make sure both password fields match exactly.
</Note>

### Invitation Sign Up

If you've been invited to join a workspace, you'll receive an email with a special invitation link:

1. Click the invitation link in your email
2. If you don't have an account, you'll be directed to sign up with your email pre-filled
3. Complete the sign-up form
4. After signing up, you'll automatically join the workspace

## Sign In

Access your account using one of three authentication methods.

### Password Sign In

The default method using your email and password:

<Steps>
  <Step title="Go to Sign In">
    Navigate to the **Sign In** page.
  </Step>

  <Step title="Select Password Tab">
    Click the **Password** tab (selected by default).
  </Step>

  <Step title="Enter Credentials">
    Enter your registered **Email** address and **Password**.
  </Step>

  <Step title="Sign In">
    Click **Sign In** to access your account. You'll be redirected to your dashboard or agents page.
  </Step>
</Steps>

<Tip>
  If you've forgotten your password, click the **Forgot password?** link below the form.
</Tip>

### Magic Link Sign In

For passwordless authentication, use the magic link option:

<Steps>
  <Step title="Select Magic Link Tab">
    On the sign-in page, click the **Magic Link** tab.
  </Step>

  <Step title="Enter Your Email">
    Enter the email address associated with your account.
  </Step>

  <Step title="Send Magic Link">
    Click **Send Magic Link**. You'll see a confirmation message.
  </Step>

  <Step title="Check Your Email">
    Open your email and click the magic link to sign in instantly. The link will redirect you to your dashboard.
  </Step>
</Steps>

<Note>
  Magic links are single-use and expire after a short period. If your link doesn't work, request a new one.
</Note>

### Anonymous Sign In

Try the platform without creating a full account:

<Steps>
  <Step title="Select Anonymous Tab">
    On the sign-in page, click the **Anonymous** tab.
  </Step>

  <Step title="Continue Anonymously">
    Click **Continue Anonymously** to create a temporary session.
  </Step>
</Steps>

Anonymous sessions allow you to explore the platform before committing to registration. You can link your anonymous session to a full account later.

## Password Reset

If you've forgotten your password, you can reset it:

<Steps>
  <Step title="Go to Forgot Password">
    On the sign-in page, click **Forgot password?** to access the password reset page.
  </Step>

  <Step title="Enter Your Email">
    Enter your registered email address.
  </Step>

  <Step title="Request Reset Link">
    Click **Send Reset Link**. You'll see a confirmation screen telling you to check your email — you are not redirected back to the sign-in page. If an account with that email exists, a password reset email will be sent.
  </Step>

  <Step title="Check Your Email">
    Open the password reset email and click the reset link.
  </Step>

  <Step title="Set New Password">
    Enter your new password (at least 8 characters) and confirm it. Click **Reset Password** to save.
  </Step>
</Steps>

<Warning>
  Password reset links expire after a limited time for security. If your link has expired, request a new one.
</Warning>

## Protected Routes

Certain pages require authentication to access. If you try to visit these pages without being signed in, you'll be automatically redirected to the sign-in page.

| Route         | Description                        |
| ------------- | ---------------------------------- |
| `/dashboard`  | Your main workspace overview       |
| `/agents`     | Agent management and configuration |
| `/onboarding` | New agent creation wizard          |
| `/settings`   | Account and workspace settings     |

After signing in, you'll be redirected back to your intended destination.

## Session Management

Your session remains active until you sign out or it expires. For security:

* Sessions are stored securely as HTTP-only cookies
* You can sign out from any page using the account menu
* Signing in from a new device creates a new session

## Troubleshooting

<AccordionGroup>
  <Accordion icon="circle-xmark" title="Passwords don't match error">
    Make sure both the Password and Confirm Password fields contain exactly the same value. Passwords are case-sensitive.
  </Accordion>

  <Accordion icon="lock" title="Password too short error">
    Your password must be at least 8 characters long. Try a longer password that combines letters, numbers, and symbols.
  </Accordion>

  <Accordion icon="envelope" title="Magic link not received">
    Check your spam or junk folder. If the email still doesn't arrive after a few minutes, verify that you entered the correct email address and try again.
  </Accordion>

  <Accordion icon="user-xmark" title="Account not found for magic link">
    Magic links only work for existing accounts. If you don't have an account yet, use the Sign Up page to create one first.
  </Accordion>

  <Accordion icon="key" title="Password reset link expired">
    Password reset links expire for security reasons. Request a new reset link from the forgot password page.
  </Accordion>

  <Accordion icon="circle-exclamation" title="Email not verified error">
    Check your email inbox for a verification link. Click it to verify your email, then try signing in again.
  </Accordion>

  <Accordion icon="right-to-bracket" title="Can't access protected pages">
    Protected pages require authentication. Sign in first, then try accessing the page again.
  </Accordion>

  <Accordion icon="user-check" title="Email already registered">
    If you see "This email is already registered", an account with that address already exists. Click **Sign In** in the notification or navigate to the sign-in page to access your account. Use **Forgot password?** if you don't remember your password.
  </Accordion>

  <Accordion icon="circle-xmark" title="Invalid credentials error">
    If you see "Wrong email or password. Please try again.", double-check your email and password. Use the **Forgot password?** link to reset if needed.
  </Accordion>

  <Accordion icon="clock" title="Account temporarily locked">
    After multiple failed login attempts, your account may be temporarily locked. Wait a few minutes before trying again.
  </Accordion>

  <Accordion icon="envelope-open" title="Email not yet verified">
    If you see a message about verifying your email, check your inbox for the verification link and click it before signing in.
  </Accordion>
</AccordionGroup>

## Security Best Practices

<CardGroup cols={2}>
  <Card title="Use Strong Passwords" icon="lock">
    Create passwords with at least 8 characters. Use a mix of letters, numbers, and symbols.
  </Card>

  <Card title="Keep Email Secure" icon="envelope">
    Your email is used for password resets and magic links. Keep your email account secure.
  </Card>

  <Card title="Don't Share Credentials" icon="user-shield">
    Never share your password or magic links. Use workspace invitations for team access.
  </Card>

  <Card title="Sign Out When Done" icon="right-from-bracket">
    Always sign out when using shared or public computers.
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Workspace" icon="briefcase" href="/getting-started/create-workspace">
    Set up your first workspace after signing in.
  </Card>

  <Card title="Create Agent" icon="robot" href="/agents/overview">
    Learn how to create your first AI agent.
  </Card>
</CardGroup>