Skip to content

bivvy init

Initialize Bivvy configuration for your project.

Usage

Terminal window
bivvy init # Interactive setup
bivvy init --minimal # Auto-detect without prompts
bivvy init --template=rails # Start from template
bivvy init --from=../other # Copy from another project

Options

OptionDescription
--minimalGenerate config without prompts
--templateStart from a specific template
--fromCopy configuration from another project
--forceOverwrite existing configuration

What It Does

  1. Scans your project for technologies
  2. Detects package managers and version managers
  3. Identifies potential conflicts
  4. Generates .bivvy/config.yml
  5. Updates .gitignore for local overrides

Examples

Terminal window
# Interactive setup
bivvy init
# Quick setup for CI
bivvy init --minimal
# Force overwrite existing config
bivvy init --force

Detection

Bivvy automatically detects:

  • Languages: Ruby, Node.js, Python, Rust, Go, etc.
  • Package Managers: npm, yarn, pnpm, bundler, pip, cargo
  • Version Managers: asdf, mise, volta
  • Frameworks: Rails, React, Django, etc.

Conflicts

When conflicts are detected (e.g., multiple lock files), Bivvy will:

  1. Show a warning about the conflict
  2. Suggest a resolution
  3. Allow you to choose which to include