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:

Detect the project type — checks for package.json (web), go.mod (golang), or falls back to none
Prompt you to confirm a preset — auto-detected preset is suggested, but you can override
Create a branch in the target repo (default: chore/init-buck-bronson)
Add workflow files to .github/workflows/ — thin caller workflows that delegate to reusable workflows in buck-bronson
Create required labels — needs-review, needs-attention, error
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
`--preset <name>`	Auto-detect	Dev environment preset: `web`, `golang`, `none`
`--workflows <list>`	`bucky-dispatch,bucky-comments,bucky-code-review`	Comma-separated workflows to include
`--branch <name>`	`chore/init-buck-bronson`	Branch name for the PR
`--dry-run`	—	Preview changes without writing to the remote

Examples

# Initialize with web preset
bucky fetch-rewards/my-service --preset web

# Only add code review workflow
bucky fetch-rewards/my-service --workflows bucky-code-review --preset web

# 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

Project type detection checks the remote repo for marker files:

Marker file	Detected preset
`package.json`	`web`
`go.mod`	`golang`
Neither	`none`