Bivvy

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

pip install bivvy

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

Documentation

Full documentation available at bivvy.dev

• Configuration
• Templates
• CLI Reference

Supported Platforms

License

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