For agents: an index of these docs is at /docs/llms.txt, and this page as markdown is at /docs/first-hour.md.
Your first hour
A guided first run: set Dobby up, write one small ticket, watch it become a reviewed pull request, and merge it.
You will give Dobby one small ticket and follow it to a merged pull request. Most of the hour is waiting.
Pick a repo you own on GitHub that has tests.
Set up
-
Pick your repo and take the recommended answers. Say yes to the background jobs.
Terminal npx dobby-ai init -
Check that every required row has a tick.
Terminal dobby doctor
Write a ticket
Use your repo's folder name in place of shopfront.
dobby add shopfront "Fix the footer spacing" "the footer has 16px padding on phones"#1 size M, risk medium (words)The last part is the done-when line. The Tester checks the work against it.
Watch it build
-
See what is building.
Terminal dobby status -
Follow your ticket's steps. Run it every few minutes.
Terminal dobby show 1
You will see the build, your tests, then the Tester. On a new repo, Dobby first reads the repo once.
Read the pull request
Open your repo's Pull requests tab on GitHub. Dobby's pull request has the review's findings, a summary and a cost comment.
Merge it
-
Turn merges on. A fresh install keeps them paused.
Terminal dobby resume merges -
Merge your ticket's pull request.
Terminal dobby merge 1
Refresh the pull request on GitHub. It is merged.
From now on Dobby merges passing pull requests itself. Your safety preset decides which ones wait for you.