Web Settings

Opening Settings

• Sidebar: click Settings → route /settings.
• Deep link: http://localhost:3000/settings?tab=<tab>
• CLI: beebridge manager setup --tab <tab> or beebridge web settings --tab <tab>

Tab Values

Connection

Enter the Gateway URL and Token, then click Connect. This loads provider catalogs, auth profiles, and model policy from GET /api/settings/pm.

Most app pages use same-origin /api rewrites via Next.js. The Settings panel uses its own URL/token fields, useful when the gateway runs on a different host or port.

Profiles (auth)

Register manager credentials used by PM flows.

• Provider — From gateway provider catalog.
• Sign-in mode — api_key or oauth (OpenAI shows "Codex" for OAuth).
• Save profile — POST /api/settings/auth/profiles
• OAuth / Codex login — Device flow via POST /api/settings/auth/device/start + complete.
• Activate — Click a saved profile card. PATCH /api/settings/auth/profiles/:id/activate.
• Delete — DELETE /api/settings/auth/profiles/:id.
• Reset all — DELETE /api/settings/auth/profiles.

Model Policy (model)

• Default provider / model — PM defaults.
• Allowed models — Comma-separated list.
• Fallback model — Optional.
• Save — PUT /api/settings/model-policy.

Workspace

All settings, history, and data are stored under the configured workspace path. .beebridge/workspace is created under it.

• Change Workspace — PUT /api/settings/workspace with { "workspacePath": "..." }.
• On tab focus, loads GET /api/settings/workspace to show current path, data root, and file list.

Diagnostics (status)

Read-only summary: active profile, default provider/model, allowed model count.

• Restart gateway — POST /api/admin/restart. Shuts down the gateway; restart from terminal if needed.

Environment Variables (Next / browser)