Team members receive an email invitation to activate their account and sign in to the workspace.

For system architecture, read the [Platform overview](/docs/overview).

## Accessing your workspace

1. Open the activation link from your invitation email and set a password.
2. Sign in to the web workspace.
3. Add teammates from **Settings → Organization**.

## Connecting the CLI

To pair the terminal agent with your workspace:

```bash
mivia login --email engineer@your-domain.com
```

Once authenticated, runs started in the terminal stream progress and tool activity directly to your web workspace.

## Configuring model providers

Mivia uses a Bring Your Own Keys (BYOK) model. Provider credentials are encrypted using AES-256-GCM before storage:

| Provider | Usage | Key type |
| -------- | ----- | -------- |
| OpenRouter | Terminal and workspace runs | API key |
| Anthropic | Terminal and workspace runs | API key |
| OpenAI | Terminal and workspace runs | API key |

## What to read next

- [The Mivia Agent](/docs/mivia-agent) - Local terminal architecture, git worktrees, and web control.
- [BYOK credentials](/docs/byok) - Encrypted key management for model providers.
- [Knowledge base](/docs/knowledge-base) - Storing repository conventions and architecture context.