Getting started

Fund your AI

Bring your own provider keys, or let Foreman fund and route the models.

About 5 minutes

Foreman runs on large language models, and somebody has to pay for the tokens. There are two ways, and the product is identical either way.

The two models

Bring your own keys (BYOK). You add your own provider API keys and settle with that provider directly. Foreman routes work to your keys.

Managed AI. Foreman buys the capacity and bills you. Your plan includes a monthly AI credit allowance; usage beyond it draws on your balance.

Both are plan-gated: chatting with your Chief of Staff works without a plan, but scoping and running objectives needs one.

Steps

  1. Go to Settings → Billing and pick a tier.
  2. Choose BYOK or Managed when prompted.
  3. For BYOK, add keys under Settings → Providers and check each shows healthy.
  4. Optionally set auto top-up so a long-running objective can't stall overnight.

You're done when Settings → Billing shows an active plan, and Providers shows either a healthy key or a funded balance.

Gotchas

  • BYOK is not a substitute for a plan. It changes who pays for tokens, not whether you have a licence to run work.
  • Don't pin a model unless you mean it. Foreman routes each task to a model that meets that task's bar, favouring cheaper models that clear it. Pinning one model everywhere usually costs more without improving output.

Checked against

  • helpers/pricingCatalog.ts
  • helpers/subscriptionGating.tsx