commitlydocs
← back to home
auth

commitly-agent login

Authenticate this machine via the browser.

commitly-agent login

## description

Opens an OAuth flow in your default browser. On success, the dashboard returns a short-lived config blob; the CLI writes the GitHub token and (if present) Gemini key into your OS keychain, then mints an Ed25519 keypair and registers the public half with the dashboard for signed timestamp attestations. The poll loop times out after 5 minutes.

## example

$ commitly-agent login

→ Open this URL in your browser to log in:
   https://commitly.dev/auth/cli?session=8f3a…

Waiting for authentication (times out in 5 minutes)...
✓ Authenticated. Credentials stored in OS keychain.
✓ Device paired. This machine can now emit signed timestamp attestations.

## notes

See the full command reference, or jump to Daemon mode if you plan to run this unattended.