Skip to content

Authentication

One GthonrAgents login covers every capability. CLI and MCP calls share the same credential runtime.

Use the default flow on a local desktop:

Terminal window
gthonragents login

Tool-call runtimes should not block while a human uses the browser.

  1. Start a login session.

    Terminal window
    gthonragents login --headless --no-wait --json
  2. Show the returned verification_uri and user_code to the human.

  3. After the human confirms completion, run the returned poll command or:

    Terminal window
    gthonragents login poll --session <login-session-id> --json --wait
  4. Verify the account.

    Terminal window
    gthonragents status

At runtime, GthonrAgents checks credentials in this order:

  1. GTHONRAGENTS_API_KEY
  2. the operating-system keyring
  3. the owner-only credential file used on headless systems

Credentials are never returned by authentication commands. On macOS and Windows, persistent credentials use the platform credential manager. Headless Linux automatically falls back to an encrypted local file.

Terminal window
gthonragents logout