]`, `agnt5 auth logout`, `agnt5 auth whoami` **Credential store**: `~/.agnt5/config.yaml` (persisted on login, read on every invocation) **Env overrides**: `AGNT5_API_KEY` bypasses the login command; `AGNT5_API_URL` overrides the Control Plane URL **Auth flow**: browser-based OAuth via PropelAuth; CLI polls the Control Plane until an API key is issued ### `agnt5 auth login`

Launches the authentication flow. By default the CLI requests a short-lived session ID from the Control Plane, opens your browser to the PropelAuth login screen, and polls until an API key is issued. The generated key is persisted to `~/.agnt5/config.yaml` so subsequent commands can reuse it. ### Syntax ```bash agnt5 auth login [options] ``` ### Options | Flag | Description | | --- | --- | | `--api-key ` | Skip the browser flow and provide an existing API key. The CLI validates the key by fetching the current user before saving it locally. | The CLI respects `AGNT5_API_URL` and other context settings when constructing the OAuth URLs, so ensure your context is correct before logging in. You can also provide `AGNT5_API_KEY` in the environment to bypass the login command entirely.

OAuth flow With API key Success response ```bash agnt5 auth login ``` ``` Starting authentication flow... ✓ Session ID requested from Control Plane Opening browser for authentication... → https://auth.agnt5.com/propelauth/login Waiting for authentication to complete... ✓ Authentication successful ✓ API key saved to ~/.agnt5/config.yaml You are now authenticated as: user@example.com ``` ```bash agnt5 auth login --api-key agnt5_sk_abc123... ``` ``` Validating provided API key... ✓ API key is valid ✓ User verified: user@example.com ✓ API key saved to ~/.agnt5/config.yaml Authentication complete. ``` ```bash agnt5 auth login ``` ``` ✓ Already authenticated as: user@example.com ✓ API key is valid and active Current context: production API URL: https://api.agnt5.com No action needed. ```

### `agnt5 auth logout`

Clears any stored API keys and tokens from `~/.agnt5/config.yaml`. You can re-authenticate later with `agnt5 auth login`. ### Syntax ```bash agnt5 auth logout ```

Logout Already logged out ```bash agnt5 auth logout ``` ``` ✓ API key cleared from ~/.agnt5/config.yaml ✓ Authentication tokens removed You have been logged out successfully. Use 'agnt5 auth login' to authenticate again. ``` ```bash agnt5 auth logout ``` ``` No authentication credentials found. Already logged out. ```

### `agnt5 auth status`

Displays whether you are authenticated, printing the email associated with the stored key along with the active environment and API base URL. If the saved key is invalid the command reports the failure and suggests `agnt5 auth login`. ### Syntax ```bash agnt5 auth status ```

Authenticated Invalid key Not authenticated ```bash agnt5 auth status ``` ``` ✓ Authenticated as: user@example.com ✓ API key is valid Environment: production API URL: https://api.agnt5.com Context: production Authentication status: Active ``` ```bash agnt5 auth status ``` ``` ✗ Authentication failed ✗ Stored API key is invalid or expired Please run 'agnt5 auth login' to re-authenticate. ``` ```bash agnt5 auth status ``` ``` ✗ Not authenticated No API key found in ~/.agnt5/config.yaml Run 'agnt5 auth login' to authenticate. ```

### `agnt5 whoami`

Prints the email address tied to the stored credentials. This command is also available via `agnt5 auth whoami` and returns `Not authenticated` when no valid key is present. ### Syntax ```bash agnt5 whoami ```

Authenticated Not authenticated ```bash agnt5 whoami ``` ``` user@example.com ``` ```bash agnt5 whoami ``` ``` Not authenticated ```

### `agnt5 version`

Display CLI build metadata including version string, Go runtime, and platform. Use this command to inspect the CLI build information. ### Syntax ```bash agnt5 version ``` Use `agnt5 version` paired with `agnt5 whoami` to confirm both your binary and credentials before deploying.

Version info With whoami ```bash agnt5 version ``` ``` AGNT5 CLI v1.2.3 Build Information: Version: 1.2.3 Go version: go1.21.0 Platform: darwin/amd64 Build date: 2024-01-15 10:30:45 Git commit: abc1234 ``` ```bash agnt5 version && agnt5 whoami ``` ``` AGNT5 CLI v1.2.3 Build Information: Version: 1.2.3 Go version: go1.21.0 Platform: darwin/amd64 Build date: 2024-01-15 10:30:45 Git commit: abc1234 user@example.com ```