Utility Commands

Utility commands for configuration, scheduling, and repository management.

open-settings

Open GitHub repository and organization settings in your browser.

buddy open-settings [options]

Description

Quickly open the GitHub settings pages needed to configure permissions for buddy. This includes repository settings, organization settings, and Actions configurations.

Options

Settings Types

• repo - Repository settings page
• actions - Repository Actions settings
• org - Organization settings
• tokens - Personal access tokens page

Examples

# Open repository settings
buddy open-settings

# Open Actions settings
buddy open-settings --type actions

# Open organization settings
buddy open-settings --type org

# Open personal tokens page
buddy open-settings --type tokens

What Opens

Repository Settings (--type repo)

• General repository settings
• Collaborators and teams
• Branches and protection rules

Actions Settings (--type actions)

• GitHub Actions permissions
• Workflow permissions
• Runner settings

Organization Settings (--type org)

• Member privileges
• Third-party access
• GitHub Apps

Tokens (--type tokens)

• Personal access tokens management
• Fine-grained tokens

schedule

Run automated updates on a schedule.

buddy schedule [options]

Description

Execute buddy updates on a predefined schedule. This command is typically used in CI/CD environments or cron jobs for automated dependency management.

Options

Examples

# Run scheduled updates (uses config)
buddy schedule

# Override cron schedule
buddy schedule --cron "0 2 * * 1"

# Different timezone
buddy schedule --timezone "America/New*York"

# Dry run to preview changes
buddy schedule --dry-run

# Override update strategy
buddy schedule --strategy patch

Cron Expressions

Common scheduling patterns:

# Every day at 2 AM UTC
buddy schedule --cron "0 2 * * *"

# Weekly on Monday at 2 AM
buddy schedule --cron "0 2 * * 1"

# Every 6 hours
buddy schedule --cron "0 */6 * * *"

# Weekdays at 9 AM
buddy schedule --cron "0 9 * * 1-5"

Configuration Integration

The schedule command uses settings from buddy.config.ts:

export default {
  schedule: {
    cron: '0 2 * * 1', // Weekly on Monday at 2 AM
    timezone: 'UTC',
  },
  packages: {
    strategy: 'patch', // Used by scheduler
  },
} satisfies BuddyConfig

CI/CD Integration

GitHub Actions

name: Scheduled Dependencies
on:
  schedule:

    - cron: '0 2 * * 1'

jobs:
  update:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:

      - uses: actions/checkout@v4
      - uses: oven-sh/setup-bun@v1
      - run: bunx @buddysh/buddy schedule

        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Cron Job

# Add to crontab
0 2 * * 1 cd /path/to/project && bunx @buddysh/buddy schedule

Output

The schedule command provides detailed information about:

• Execution time and timezone
• Updates found and strategy used
• Pull requests created or updated
• Errors and warnings

Troubleshooting

Schedule not running:

• Check cron expression syntax
• Verify timezone settings
• Ensure GitHub token is valid

No updates found:

• Run with --verbose for detailed scanning
• Check package ignore list
• Verify package.json exists

Permission errors:

• Check GitHub token scopes
• Verify repository access
• Review workflow permissions