FAQ
Short answers to common Bilbis setup, pipeline, billing, and account questions.
Getting started
What do I need before the first pipeline?
You need one LLM provider credential, one Git provider credential, a product, and at least one repository. See Setup checklist.
Why is the setup checklist still visible?
The checklist auto-hides only after every prerequisite is satisfied. Check the missing item and finish that setup step.
What is the difference between a product and a repository?
A product groups related repositories and shared automation settings. A repository is the actual codebase Bilbis works in. See Products and Repositories.
Pipelines
What is a pipeline?
A pipeline is one run of work. You describe the task, and Bilbis plans, codes, tests, reviews, pushes, and merges through a team of agents. See What is a pipeline.
Why is my pipeline awaiting clarification?
An agent needs a decision before continuing. Open the pipeline detail page and answer the question. See Awaiting clarification.
Why did my pipeline fail?
Open the pipeline detail page and check Diagnostics. Common reasons include budget cap, missing configuration, repeated CI failure, provider errors, and unclear tasks. See Pipeline failed.
Why did dispatching the pipeline fail with a router error?
Engine Auto failed to pick a concrete engine. The banner usually says "Couldn't auto-route this pipeline: <reason>" - typical reasons are missing LLM credentials or a temporary backend issue. Either add an LLM credential in Settings → Integrations or pick a concrete engine in the form. See Pipeline didn't dispatch.
What does the vision_skipped action mean on the timeline?
Bilbis tried to analyze an image attached to the task but skipped it because no Anthropic BYOK token was on file. The detail block links to Settings → Integrations so an admin can add the credential. After the credential is in place, dispatch a new pipeline - Bilbis won't retroactively re-process images on a finished run.
What does executor_upgraded mean on the timeline?
Bilbis swapped the running engine for a stronger one mid-pipeline because the work needs more capability than the originally picked engine offers. Common case: image context detected on a claude-haiku run gets upgraded to claude-sonnet. The detail block names the from/to engines and the reason. No action needed.
Why does my pipeline say "Merge blocked"?
The provider rejected Bilbis's last merge attempt. The banner names the reason in plain English (conflicts, CI failing, missing approvals, open discussions, draft state, or branch protection). Fix the named issue at the source and a scheduled job retries every ten minutes. See Clarifications and approvals → Merge blocked.
Why does my pipeline say "Paused — ticket on hold"?
The linked Jira ticket moved into one of the Hold statuses configured in Settings → Integrations → Jira. Move the ticket out of the hold status and Bilbis resumes the pipeline on the next webhook poll. See Jira setup → Trigger, cancel, and hold statuses.
What does "Configure Jira fields" mean?
Bilbis tried to move the linked Jira ticket through a workflow status that requires fields you haven't mapped yet. An admin needs to add a row for each missing field in Settings → Integrations → Jira → Transition field mappings and retrigger the pipeline. The Timeline tab callout names the exact field IDs Jira asked for. See Jira setup → Transition field mappings.
Does a dry run cost money?
Yes. A dry run still uses agents and engines. It stops before pushing a branch or opening an MR/PR, but it does not skip model cost. See Budgets, dry runs, and priority.
Why did a high-priority pipeline not start immediately?
Priority affects queued pipelines on the same repository. It does not stop a pipeline already running. See Budgets, dry runs, and priority.
Can Bilbis retry a failed pipeline automatically?
Not currently in the documented user flow. Create a new pipeline with the same task, adjust the prompt or setup, or use a saved template.
Integrations
What does bring your own key mean?
Your organization supplies the provider keys Bilbis uses for agent and Git work. See BYOK.
Which credentials are needed first?
For the first useful pipeline, add one LLM provider credential and one Git provider credential. See LLM providers and Git providers.
Why does Jira not appear in the normal credential picker?
Jira uses a dedicated setup card because it needs both a credential and workflow configuration. See Jira setup.
What happens if I delete a credential?
Pipelines that depend on that key can fail until you add a replacement. Validate replacement credentials before running more pipelines.
Why does my Integrations page only show provider names with no buttons?
Your role is Developer or Viewer. Bilbis renders a read-only Configured providers summary card for non-admin roles. Adding, validating, or rotating credentials needs Owner or Admin access. See Integrations settings → Read-only summary view.
Why does my repo show "Stale" on languages?
The language breakdown was last fetched more than 30 days ago. Click Refresh languages on the repo row to fetch a current breakdown from the Git provider. The Stale badge clears once the fetch succeeds. See Repositories → Languages.
Why is the Refresh languages button missing?
Refreshing languages is admin or owner only. Developers and viewers see the breakdown but cannot trigger a refresh. Ask an admin to refresh if the data looks stale.
Account and access
Which roles must use MFA?
Owner, admin, and platform-admin roles may be forced to enroll in MFA. Developer and viewer MFA is voluntary in the documented flow. See Multi-factor authentication.
Can I change my account email?
Not from Profile settings. Email is the account username and cannot be changed there. See Profile settings.
Why can I see a page but not click an action?
Your role may not allow that action. Admin or owner access is usually required for organization-wide setup, billing changes, member management, and credentials. See Organizations and roles.
What should I do if I do not recognize a session?
Revoke the session. If several look unfamiliar, revoke all other sessions and change your password. See Security settings.
Billing and analytics
Who can change billing?
Organization admins and owners can change self-serve subscriptions or open the billing portal. See Manage billing.
Which plans are self-serve?
Starter, Team, and Business are self-serve plans. Trial is assigned automatically, and Enterprise is managed offline. See Plans and usage.
Why does Analytics not show a running pipeline's cost?
Analytics cost rows include completed pipelines only. Check the pipeline detail page for in-progress cost. See Analytics.
How often do budget alerts send?
Each budget alert can send once per calendar month when monthly spend crosses its threshold. Alerts reset on the 1st. See Analytics.