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 the Blode.md CLI with GitHub in your browser, store a local OAuth session, and unlock deploy commands like blodemd push.
Authenticate your CLI session so you can deploy documentation with blodemd push.
You only need blodemd login once per machine unless you run blodemd logout or your session expires. After login, the CLI stores OAuth tokens locally and refreshes them automatically when you run commands like blodemd push or blodemd whoami. Local deploys use your GitHub session; CI pipelines should use a project deploy key instead (see Continuous deployment).
First-time setup often looks like: install the CLI from CLI overview, run blodemd new, then blodemd login and blodemd push. If port 8787 is in use, pass --port or use --no-open in headless environments.
blodemd loginHow 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.