Pipelines

Create a pipeline

Describe what you want done and dispatch a Bilbis pipeline that produces a merge request.

What this means

A pipeline is one task you hand to Bilbis. You describe the work in plain language, pick a repository, and Bilbis dispatches a team of agents to plan it, write the code, run tests, push a branch, and open a merge request.

The form on this page is the only thing you fill in. Every other moving part - the agents, CI checks, the review pass - runs on its own.

When to use it

  • A small feature you can describe in a paragraph.
  • A bug fix where you can point at the symptom.
  • A repetitive change across one repo.
  • A frontend tweak that follows an existing design.
  • A test or documentation update.

If a task spans many repositories, see the Let Bilbis pick option below.

Before you start

You need all four of these in your organization, or the form will refuse to render:

  • An LLM credential - Anthropic or OpenAI.
  • A Git credential - GitLab or GitHub.
  • A product.
  • At least one repository inside that product.

Bilbis also surfaces this as the setup checklist on your dashboard. If anything is missing, the form replaces itself with the checklist and a deep link to the right page.

A Jira credential is optional. Without it, the Jira ticket field is disabled and shows a link to add one.

Steps

  1. Go to Pipelines → New in the sidebar.
  2. Type the task into the Task field. Be specific. Mention file paths, function names, expected behavior. The agents read this verbatim.
  3. Pick a Repository, or turn on Let Bilbis pick to give the agents a shortlist.
  4. Pick a Type - see the field reference below.
  5. Leave Engine on Auto unless you have a reason to override it. Bilbis will recommend one based on past results for that repo and task type.
  6. Set the Budget cap in dollars. The run halts if cost exceeds this.
  7. Tick Dry run if you want a plan + code without a push or MR.
  8. Optionally open Advanced options to add a ticket id, Jira ticket, Figma URL, branch overrides, or a queue priority.
  9. Click Dispatch pipeline. You land on the pipeline detail page so you can watch it run.

Field reference

Main fields

FieldWhat it meansDefault
TaskThe work the agents should do, in plain English. Required. Up to 10,000 characters.Required
RepositoryThe repo Bilbis will clone, branch, and push from. Required.Required
Let Bilbis pickToggle to hand a list of candidate repos to the Repo Router. It picks one based on the task description. Pick at least two repos.Off
TypeThe shape of the task. Affects engine recommendations and how the agents plan.Feature
EngineThe AI engine that runs the work. Auto lets Bilbis route per task.Auto
Budget cap (USD)Maximum spend in US dollars. Bilbis halts the run if cost passes this.10
Dry runPlan and write code, but skip the push and MR step.Off

Type values

TypeUse when
FeatureAdding new behavior.
Bug fixFixing broken behavior.
RefactorRestructuring code without changing behavior.
FrontendVisual or UI change, often paired with a Figma URL.
TestAdding or updating tests.
DocumentationWriting or updating docs and comments.

Engine values

EngineWhen to pick it
Auto (let Bilbis pick)Default. The Work Planner picks per task.
Claude OpusMost capable. Use for hard, ambiguous, or large tasks.
Claude SonnetBalanced. A safe default for most work.
Claude HaikuFast and cheap. Best for trivial or repetitive tasks.
OpenAI CodexUse when you specifically want OpenAI's coder.
Workers AISmallest, cheapest. Use for very simple tasks.

If a recommendation appears next to one of these options, that's the engine Bilbis suggests based on past runs for this repo and task type. You can still override it.

Advanced options

FieldWhat it meansDefault
Ticket idFree-form ticket reference from your tracker (Linear, Asana, internal codes). Travels with the pipeline and shows up in MR titles.Empty
Jira ticketA real Jira issue key, format PROJ-123. The agent fetches the issue and links the resulting MR back to it. Disabled if no Jira credential is set.Empty
Figma URLA Figma file or frame URL. The agent uses it as visual reference for frontend work.Empty
BranchOverride the working branch the agent will push. Auto-generated from the task description if blank.Auto-generated
Merge target branchThe branch the MR should target. If blank, Bilbis reads the task description for hints like "merge into dev". If unclear, the pipeline pauses and asks.Read from task
PriorityPer-repo queue priority, 1 (Highest) to 5 (Lowest). Multiple pipelines on the same repo run sequentially.Unrated (Medium)

What happens next

After you click Dispatch pipeline:

  1. You're redirected to the pipeline detail page.
  2. The state badge cycles through routing, coding, testing, pushing, CI, and reviewing.
  3. When the agents finish, the pipeline either reaches Done with an MR link, Failed, or pauses on a question (Awaiting clarification or Awaiting approval).
  4. The pipeline appears in your Pipelines list and feeds the dashboard KPIs and analytics.

If you ticked Dry run, the pipeline stops after the coding step. No branch is pushed, no MR is opened.

Templates

If you find yourself filling in the same task type, repo, engine, and budget repeatedly, save the form as a template:

  1. Fill in the fields you want to reuse.
  2. Click Save as template.
  3. Give it a short name like "Weekly dep bump" or "Frontend smoke test".

Templates lock to a concrete engine. If you saved with Auto, the template stores Claude Sonnet instead.

Apply a template later from the Template picker at the top of the form, or open the form via ?template=<id> to auto-apply.

The Save as template button is disabled while Let Bilbis pick is on, since templates lock to a single repo.

Problems and fixes

ProblemWhat to check
The form shows a setup checklist instead of fields.One of the four prerequisites is missing - credentials, product, or repos. Follow the link in the checklist.
No repositories appear in the picker.Your product has no repos yet. Add one in Products.
The Jira ticket field is disabled.No Jira credential exists. Add one in Settings → Integrations.
"Pick at least two repos for the Repo Router to choose from."You enabled Let Bilbis pick with one or zero repos selected. Pick two or more, or turn the toggle off.
"Some fields need fixing - see highlighted inputs."One field failed validation. The form auto-expands Advanced options if the bad field is in there.
The pipeline lands in Awaiting clarification right after dispatch.The agents need more information. Open the pipeline and reply in the Clarifications tab. See Awaiting clarification.
The pipeline lands in Failed with "No config found for repo X".A known backend gap - see No config found for repo.
Cost exceeded the budget.The run halts. Either raise the budget cap on a fresh run, or split the task into smaller pieces.

On this page