Skip to main content

​
Before you start

  • A GitHub repository you can install apps on
  • Commands that build and test it (we’ll use make build and make test)
The examples use a small Go web server with lorem ipsum and notes endpoints. Any language works.

​
Steps

1

Sign in and choose repositories

Sign in with GitHub, install the Bellows GitHub App, then choose the organizations and repositories Bellows should track.
Onboarding: choose organizations and repositories
2

Check the repository is tracked

Open Settings → Repositories. Your repo is listed there, and Configure shows its environment.
Settings, Repositories
3

Add .bellows.yaml to the repo root

This file sets the runner’s container and the checks every run must pass.
.bellows.yaml
Commit and push it to the default branch.
4

Create a task

Click New task. Under What should we work on? describe the change, pick the repo and executor, then click the arrow (Start task) or press ⌘ + Enter.
Task
New task form
5

Answer questions, if any

Some tasks need a decision from you. The agent asks inline and waits. Pick an answer and click Submit.
Agent question waiting for an answer
6

Review and finish

Once the gates pass, Bellows opens a pull request and the task shows Waiting for review. Review the PR on GitHub. If it needs changes, use Follow up on the task. Once it’s merged, click Mark done.
Task waiting for review with a published pull request

The task page: conversation and follow-up on the left; outcome, verification and the published PR on the right.

​
What just happened

Queued → Running → Gates: build, test → Waiting for review → Done
The driver started a golang:1.25 runner and ran setup. Then the agent made the change. Bellows ran each gate, and the PR opened only after all of them passed.
Writing a good task description is the biggest lever on results. See Writing good tasks.