OTPilot

Stagehand

BitBar 2FA login with Stagehand: step-by-step for agents

Your Stagehand agent gets to BitBar's “enter the code from your authenticator app” screen and stops. Here is how to make it type the right 6-digit code by itself, without putting the TOTP seed in your code, prompts or logs.

  1. 1 · Save the secret

    In BitBar, turn on authenticator-app 2FA and click “Can't scan?” to reveal the setup key. Save it in your OTPilot vault — it becomes the account bitbar. Detailed BitBar steps.

  2. 2 · Create a scoped key

    Create an agent key that can read only BitBar, and put it in the agent's environment as OTPILOT_KEY.

  3. 3 · Fetch the code in Stagehand

    Fetch the code right before Stagehand fills the 2FA field, so it is always fresh.

    Stagehand · typescript
    // npm i @browserbasehq/stagehand
    async function otp(account = "bitbar") {
      const r = await fetch(`https://otpilot.vibiz.app/api/v1/codes/${account}?reason=stagehand-login`, {
        headers: { Authorization: `Bearer ${process.env.OTPILOT_KEY}` },
      });
      const data = await r.json();
      if (!r.ok) throw new Error(`${data.error.message} Fix: ${data.error.fix}`);
      if (data.status === "pending") { await new Promise((s) => setTimeout(s, 5000)); return otp(account); }
      return data.code as string;
    }
    
    await page.act("log into BitBar with the saved email and password");
    const code = await otp();
    await page.act(`type ${code} into the authenticator code field and submit`);

Good to know

Try it with your own secret — no signup

Paste a TOTP secret on the home page and get a live code plus a working API call in seconds.

BitBar with other frameworks

Use only with BitBar accounts you own and may automate. Not affiliated with BitBar or Stagehand.