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

# blodemd login

Authenticate with Blode.md via GitHub in your browser.

Authenticate your CLI session so you can deploy documentation with `blodemd push`.

```bash
blodemd login
```

## How it works

`blodemd login` opens your browser to sign in with GitHub via Supabase OAuth (PKCE). After you authorize, the CLI receives an access token and stores it locally. No API keys, ever.

The CLI starts a temporary local server on port 8787 to receive the OAuth callback. If the browser does not open automatically, copy the printed URL manually.

## Options

- `--port <port>` (type: number, default: 8787): Port for the local OAuth callback server.
- `--timeout <seconds>` (type: number, default: 180): How long to wait for browser authorization before timing out.
- `--no-open` (type: boolean, default: false): Print the authorization URL instead of opening the browser.

## Examples

```bash title="Browser sign-in"
blodemd login
```

```bash title="Custom port and no browser"
blodemd login --port 9090 --no-open
```

## Credential storage

Credentials are stored at `~/.config/blodemd/credentials.json`. The OAuth session includes a refresh token so the CLI can renew your session automatically. Run `blodemd logout` to remove stored credentials.