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
- Go to Pipelines → New in the sidebar.
- Type the task into the Task field. Be specific. Mention file paths, function names, expected behavior. The agents read this verbatim.
- Pick a Repository, or turn on Let Bilbis pick to give the agents a shortlist.
- Pick a Type - see the field reference below.
- Leave Engine on
Autounless you have a reason to override it. Bilbis will recommend one based on past results for that repo and task type. - Set the Budget cap in dollars. The run halts if cost exceeds this.
- Tick Dry run if you want a plan + code without a push or MR.
- Optionally open Advanced options to add a ticket id, Jira ticket, Figma URL, branch overrides, or a queue priority.
- Click Dispatch pipeline. You land on the pipeline detail page so you can watch it run.
Field reference
Main fields
| Field | What it means | Default |
|---|---|---|
| Task | The work the agents should do, in plain English. Required. Up to 10,000 characters. | Required |
| Repository | The repo Bilbis will clone, branch, and push from. Required. | Required |
| Let Bilbis pick | Toggle 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 |
| Type | The shape of the task. Affects engine recommendations and how the agents plan. | Feature |
| Engine | The 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 run | Plan and write code, but skip the push and MR step. | Off |
Type values
| Type | Use when |
|---|---|
| Feature | Adding new behavior. |
| Bug fix | Fixing broken behavior. |
| Refactor | Restructuring code without changing behavior. |
| Frontend | Visual or UI change, often paired with a Figma URL. |
| Test | Adding or updating tests. |
| Documentation | Writing or updating docs and comments. |
Engine values
| Engine | When to pick it |
|---|---|
| Auto (let Bilbis pick) | Default. The Work Planner picks per task. |
| Claude Opus | Most capable. Use for hard, ambiguous, or large tasks. |
| Claude Sonnet | Balanced. A safe default for most work. |
| Claude Haiku | Fast and cheap. Best for trivial or repetitive tasks. |
| OpenAI Codex | Use when you specifically want OpenAI's coder. |
| Workers AI | Smallest, 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
| Field | What it means | Default |
|---|---|---|
| Ticket id | Free-form ticket reference from your tracker (Linear, Asana, internal codes). Travels with the pipeline and shows up in MR titles. | Empty |
| Jira ticket | A 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 URL | A Figma file or frame URL. The agent uses it as visual reference for frontend work. | Empty |
| Branch | Override the working branch the agent will push. Auto-generated from the task description if blank. | Auto-generated |
| Merge target branch | The 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 |
| Priority | Per-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:
- You're redirected to the pipeline detail page.
- The state badge cycles through routing, coding, testing, pushing, CI, and reviewing.
- When the agents finish, the pipeline either reaches Done with an MR link, Failed, or pauses on a question (Awaiting clarification or Awaiting approval).
- 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:
- Fill in the fields you want to reuse.
- Click Save as template.
- 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
| Problem | What 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. |
Related pages
- Pipeline states - what each state badge means.
- Review results - what to do once a pipeline finishes.
- Troubleshooting - recovery for stuck or failed runs.