How to use DuckyHelper in GitHub
On GitHub you read a lot of code and diffs you did not write. Ask DuckyHelper about the code on screen and it explains it and circles the line that matters. You can also hand it a bug report to write up as an issue (in the Mac app); a rule for new issues is not in the app yet. It never pushes, merges or approves.
See why a loop goes one step too far
“Why does this function crash on the last item?”
- 01Open the file so the function is on the screen, then ask out loud.
- 02DuckyHelper reads the loop and what it does with each item.
- 03It circles the loop condition and underlines the line that crashes, and says why in a sentence or two.
- 04Ask for the fix and it writes it next to the code as a short note.
You getYou see the exact condition that runs one step too far, and the one-character fix.
The loop runs once too many. i reaches items.length, past the last item, so items[i] is undefined.Understand what a pull request changes
“What does this pull request change, and is anything risky?”
- 01Open the pull request on its Files changed view so the diff is on screen, then ask out loud.
- 02DuckyHelper reads the lines that were removed and added.
- 03It says in plain words what changed, circles the changed condition and underlines the riskiest line.
- 04Ask what a function does or why a line matters and it explains from the diff.
You getA plain summary of the change and the one line you should look at twice.
Adults aged 18 now qualify. The riskier line marks every new account verified without any check.File an issue with steps to reproduce
“File an issue for this bug with steps to reproduce and the bug label”
- 01Say what the bug is, or have the page with the bug on screen.
- 02DuckyHelper opens the repository's Issues tab and starts a new issue.
- 03It writes a title and the steps to reproduce with its own cursor, then adds the bug label.
- 04It files the issue with the bug label, and the run is recorded so you can check it.
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 getA clear issue with steps anyone can follow, posted only after you read it.
Ask for missing steps on new bugs
“When a new issue is labeled bug, ask the author for steps if they are missing, checking with me first”
- 01Say it once while your repository's issues are open. It does the first run on the open bugs you can see.
- 02It learns GitHub's own actions for reading and commenting the first time, so later runs are quick.
- 03Turn it on from the card it offers. From then on it runs when an issue gets the bug label.
- 04Each run lands in the history with the comment it posted.
Not in the app yetAlways-on jobs are not in the app yet: this shows how one would run. Today you can ask for the same job once, in the Mac app.
You getBugs without steps get a polite question, and you decide what is posted.
fib(50) never finishes.
Code on a screen: DuckyHelper asks you back first, then draws on the code to show why a function is slow.
Code on the screen: it asks you back first, then draws the call tree on your code to show why it is slow.
Watch the film
One line of code you did not write.
Not GitHub, but the same job: Olly Rosewell points at one line of what his coding agent reported and asks how it works. On a pull request 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 videoGetting more out of it in GitHub.
- 01
Scroll to the lines you mean before you ask. It explains the code on the screen, not the whole repository.
- 02
Ask it to explain a diff for a teammate who has not seen the code. The answer is short and plain.
- 03
On a pull request, ask what could break if this line is wrong. It points at the line and says why.
- 04
It never pushes, merges or approves. You press those buttons yourself.
Questions about GitHub.
Do I need to connect my GitHub 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 GitHub in your browser, signed in as you. It's built not to type your passwords or card numbers.
Can it post, push or merge without asking?
Not unless you ask it to: the jobs in this guide write issues and comments, and it posts them without stopping to ask, for now. A Stop control stays on the window the whole time, Take control hands it back to you, and every task is recorded so you can watch it again. Keep an eye on what it posts.
Does it read my private repositories?
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, as you.
Does it work in the GitHub app on my phone?
No. DuckyHelper is an app for Mac, Windows and Linux, so it works with GitHub in your computer's browser.
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.