Documentation

On this page 9

Buddy is one binary that does two jobs: it reviews code, and it keeps dependencies current. Everything below is the reference for driving both.

If you have not installed it yet, Getting Started is the shortest path from nothing to a first review.

Start here

PageWhat it covers
What is Buddy?The shape of the product, and what it replaces
InstallationGlobal install, project install, and the GitHub Action
Getting StartedFrom zero to a reviewed pull request
UsageThe day-to-day commands, in the order you meet them

Command line

The CLI is the whole product — the GitHub Action is a thin wrapper around these same commands.

PageWhat it covers
OverviewEvery command, grouped by what it is for
buddy setupInteractive and non-interactive setup
Local ReviewReviewing the working tree before a PR exists
Update Commandsscan, update, update-check
Package CommandsWorking with individual packages
Utility CommandsDashboards, workflows, diagnostics

AI

Buddy talks to a model you choose, with credentials that stay in your CI.

PageWhat it covers
ProvidersAnthropic, OpenAI and the rest, and how keys resolve
Agent RuntimeWhat the agent may read and change
Headless Runsbuddy run, with schema-validated output

Configuration

PageWhat it covers
Configuration GuideThe options you actually reach for
Configuration ReferenceEvery option, with defaults and types
PR GenerationTitles, bodies, labels and reviewers

Reference

The behaviour behind each feature, once you have decided you want it.

PageWhat it covers
Dependency ScanningHow manifests are found and read
Update Strategiesmajor, minor, patch, all, and package rules
Package ManagementIgnores, pins and grouping
Dependency FilesEvery manifest format Buddy understands
Pull Request GenerationWhat lands in the PR body
Release NotesWhere changelogs come from, and reference sanitizing
Labeling & AssignmentLabels, reviewers, assignees
Auto-MergeStrategies and conditions
RebaseThe checkbox, and what it refreshes
Dependency DashboardThe single-issue overview
GitHub ActionsKeeping workflow files current

Advanced

PageWhat it covers
EcosystemsAll eleven, and what each one supports
MonoreposEvery manifest at every depth, with no setting
Git ProvidersGitHub, and what provider support means
SchedulingCron, presets and what runs when

Migrating

PageWhat it covers
OverviewWhat carries across, and what does not
From RenovateReading an existing renovate.json
From DependabotReading dependabot.yml

API

For driving Buddy from your own code rather than the CLI.

PageWhat it covers
Buddy ClassScanning, updating and dashboards, programmatically
Configuration TypesBuddyConfig and the validation helpers

Elsewhere

  • Features — what each capability does, before you configure it
  • Use Cases — the same product, arranged by the problem you have
  • Comparisons — how Buddy differs from the tool you are on now
Suggest a change to this page

Last updated: