Initializing a Repository

Quick start

Run bucky inside a git repo to auto-detect the owner/repo from the origin remote:

bucky

Or pass an explicit repository:

bucky fetch-rewards/my-service

What happens

The CLI will:

1. Create a branch in the target repo (default: chore/add-bucky-code-review)
2. Add the code review workflow to .github/workflows/bucky-code-review.yml — a thin caller that delegates to the shared reusable workflow in buck-bronson
3. Add a repo config file to .bucky/config.yaml — a starter config for customizing session pods (see Repo Configuration)
4. Open a PR with everything configured

CLI options

bucky [REPO] [OPTIONS]

Flag	Default	Description
[REPO]	Detected from git remote	Target repository in owner/repo format
--branch <name>	chore/add-bucky-code-review	Branch name for the PR
--dry-run	—	Preview changes without writing to the remote

Examples

# Preview what would happen
bucky --dry-run

# Use a custom branch name
bucky fetch-rewards/my-service --branch feat/add-claude-workflows

Auto-detection

When run without a [REPO] argument, the CLI parses the local git origin remote URL (SSH or HTTPS) to resolve owner/repo. Both formats are supported:

• git@github.com:fetch-rewards/my-service.git
• https://github.com/fetch-rewards/my-service.git