30% off your first 3 months

Get the deal
GitLab logo
APP GUIDE
In your browser

How to use DuckyHelper in GitLab

A red pipeline or a long merge request eats the morning. Ask DuckyHelper about the job log or the diff on screen and it explains it and circles the line that matters. Hand it a retry or review comments and it does them in GitLab (in the Mac app), with a Stop control on the window the whole time. It never merges or pushes.

Works on Mac, Windows and LinuxDoing jobs is in the Mac app
01
ASK
Works now

Read a failed pipeline job

YOU SAY
“Why did this pipeline job fail?”
Press fn (Ctrl+Shift+Space on Windows and Linux) and say it out loud.
What happens
  1. 01Open the failed job so its log is on the screen, then ask out loud.
  2. 02DuckyHelper reads from the command that ran down to the last line.
  3. 03It circles the error and underlines where it points to in the code, and says what failed.
  4. 04Ask whether it is the code or the runner and it tells you from the lines it sees.

You getYou know whether it is a real test failure, and the file and line to open.

Job: test - GitLab
gitlab.com
1$ npm test2FAIL src/cart.test.js3expected total 45.00, received 54.004at calcTotal (src/cart.js:18:11)5ERROR: Job failed: exit code 1
A test expected 45.00 and got 54.00. The sum is wrong at line 18 of cart.js: a code problem, not the runner.
Demo · example pageClip · 6 sStill
02
ASK
Works now

Understand a merge request

YOU SAY
“What does this merge request change?”
Press fn (Ctrl+Shift+Space on Windows and Linux) and say it out loud.
What happens
  1. 01Open the merge request on its Changes view so the diff is on screen, then ask out loud.
  2. 02DuckyHelper reads the removed and added lines.
  3. 03It explains the change in plain words and circles the line that could surprise someone.
  4. 04Ask whether a test would catch it and it answers from what the diff shows.

You getYou know what the change does and which line to question in review.

Merge request: Apply the new discount - GitLab
gitlab.com
1discounts.js2- return price * (1 - rate);3+ return price * (1 + rate);4// apply to the cart total
The discount now adds to the price instead of taking it off. The plus sign is likely a mistake.
Demo · example pageClip · 6 sStill
03
JOB
On Mac

Retry a failed job and report back

YOU SAY
“Retry the failed test job and tell me if it passes”
Press fn (Ctrl+Shift+Space on Windows and Linux) and say it out loud.
What happens
  1. 01Open the pipeline, or say which one, and it finds the failed test job.
  2. 02It uses the job's Retry button with its own cursor while you keep working.
  3. 03It waits on the job page while the new run goes, and reads the result.
  4. 04It tells you out loud whether the run passed or failed, and shows the last lines of the log.

You stay in controlIt does the job without stopping to ask. A Stop control stays on the window the whole time, Take control hands it back to you, and the task is recorded so you can watch it again.

You getYou hear whether the retry passed without watching the pipeline.

Retry the test jobExample · Mac app
Demo · example data · Mac appClip · 8 sStill
04
JOB
On Mac

Leave review comments

YOU SAY
“Comment on this merge request with the two issues you found”
Press fn (Ctrl+Shift+Space on Windows and Linux) and say it out loud.
What happens
  1. 01Have the merge request open, or say its name.
  2. 02DuckyHelper reads the changes and finds the two problems it will mention.
  3. 03It writes each comment on the right line with its own cursor.
  4. 04It posts both comments on the merge request, and the run is recorded so you can check them.

You stay in controlIt does the job without stopping to ask. A Stop control stays on the window the whole time, Take control hands it back to you, and the task is recorded so you can watch it again.

You getTwo clear review comments, on the right lines, posted only after you read them.

Review commentsExample · Mac app
Demo · example data · Mac app
FROM A REAL SESSION

A test report, in plain words.

Not GitLab, but the same job: Olly Rosewell asks what his coding agent's test report means, then what to do next. On a job log you ask the same way.

From Olly Rosewell's video, where he builds a small app with a coding agent and asks DuckyHelper about what it wrote.

Every chapter of the video
Plays from YouTube, only once you press play. Watch on YouTube
TIPS

Getting more out of it in GitLab.

  • 01

    Open the failing job first, not the pipeline overview. The error is in the job log, and that is what it reads.

  • 02

    Scroll the log to the first red line before you ask. Later lines are often only the fallout.

  • 03

    Ask it to say the fix in one sentence, then look at the file yourself before you push anything.

  • 04

    It never merges or pushes. Pressing Merge stays yours.

FAQ

Questions about GitLab.

Do I need to connect my GitLab account?

No. There is nothing to connect. It sees what is on your screen while the pill is open, and for jobs (in the Mac app) it uses GitLab in your browser, signed in as you. It's built not to type your passwords or card numbers.

Can it merge or push on its own?

No. It never merges or pushes. If you ask it to send or post something, it does it without stopping to ask, and you can press Stop at any moment.

Does it see my other projects?

Only what is on your screen while the pill is open. A job you start in the Mac app opens the pages that job needs.

Does it work on a self-hosted GitLab?

It works with whatever GitLab page is open in your computer's browser, because it reads the screen like a person does. DuckyHelper is an app for Mac, Windows and Linux.

Questions and jobs

Do anything

Ask it a question or hand it a job, in any app.

Doing jobs for you is in the Mac app. Asking works on Mac, Windows and Linux.