Skip to content

Authentication

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

Use the default flow on a local desktop:

Terminal window
usetrawsn login

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

  1. Start a login session.

    Terminal window
    usetrawsn 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
    usetrawsn login poll --session <login-session-id> --json --wait
  4. Verify the account.

    Terminal window
    usetrawsn status

At runtime, UseTrawsn checks credentials in this order:

  1. USETRAWSN_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
usetrawsn logout