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

# Login

> Authenticate the CLI with GroundForge SaaS.

Log in to the SaaS platform and save the active context:

```bash theme={null}
gforge login \
  --url https://platform.groundforge.ai \
  --organization <organization-id-or-name> \
  --workspace <workspace-id-or-name> \
  --environment dev \
  --username you@example.com
```

Enter the password only when prompted. Do not place it directly in shell history.

Check the saved context and connectivity:

```bash theme={null}
gforge context -o yaml
gforge doctor
```

Use `gforge context set` to change the active Organization, Workspace, or environment without logging in again.

See [Context](/cli/context).


## Related topics

- [Install](/cli/install.md)
- [API Authentication](/api-reference/authentication.md)
- [CLI Overview](/cli/overview.md)
- [Reference](/cli/reference.md)