Skip to content
Blode.md

AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.

blodemd login

Authenticate with Blode.md via GitHub in your browser.

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

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

FieldTypeDescriptionRequiredDefault
--port <port>numberPort for the local OAuth callback server.Yes8787
--timeout <seconds>numberHow long to wait for browser authorization before timing out.Yes180
--no-openbooleanPrint the authorization URL instead of opening the browser.Yesfalse

Examples

blodemd login

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.