Skip to content

bivvy-dev/bivvy

Repository files navigation

Bivvy

CI coverage

Cross-language development environment setup automation, built in Rust.

Bivvy replaces ad-hoc bin/setup scripts with declarative YAML configuration, smart state tracking, and a polished CLI.

Installation

Quick install (macOS/Linux):

curl -fsSL https://bivvy.dev/install | sh

Homebrew:

brew install https://raw.githubusercontent.com/bivvy-dev/bivvy/main/dist/homebrew/bivvy.rb

Cargo:

cargo install bivvy

gem:

gem install bivvy

pip:

pip install bivvy

See Installation docs for details on each method.

Quick Start

cd my-project
bivvy init
bivvy run
bivvy status

What It Does

# .bivvy/config.yml
app_name: myapp

steps:
  brew:
    template: brew
  ruby:
    template: bundler
    watches: [Gemfile.lock]
  node:
    template: yarn
    watches: [yarn.lock]
  db:
    command: "rails db:prepare"
    depends_on: [ruby]

workflows:
  default:
    steps: [brew, ruby, node, db]
  • State tracking — only re-runs what's needed
  • Watch files — detects when dependencies change
  • Error recovery — retry, fix, skip, or drop to shell
  • Template registry — reusable, shareable step definitions
  • Remote sources — central team templates via HTTP or Git
  • Secret masking — sensitive values hidden in output
  • Multiple output formats — human, JSON, SARIF for lint

Commands

Command Description
bivvy run Run setup workflow
bivvy init Initialize configuration
bivvy status Show current status
bivvy list List steps and workflows
bivvy lint Validate configuration
bivvy last Show last run info
bivvy history Show execution history
bivvy config Show resolved configuration
bivvy cache Manage template cache
bivvy feedback Capture friction points
bivvy completions Generate shell completions

Documentation

Shell Completions

bivvy completions bash > ~/.local/share/bash-completion/completions/bivvy
bivvy completions zsh > ~/.zfunc/_bivvy
bivvy completions fish > ~/.config/fish/completions/bivvy.fish

Supported Platforms

Platform Architecture
Linux x64, arm64
macOS x64, arm64
Windows x64

License

FSL-1.1-Apache-2.0 - Functional Source License with Apache 2.0 future license (converts to Apache 2.0 after 2 years)

About

Dev setup, automated.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors