Skip to content

bivvy run

The main command to run your setup workflow.

Usage

Terminal window
bivvy
Terminal window
bivvy run
Terminal window
bivvy run -w ci

Options

OptionShortDescription
--workflow-wWorkflow to run (default: “default”)
--onlyRun only specified steps (comma-separated)
--skipSkip specified steps (comma-separated)
--skip-behaviorHow to handle skipped dependencies
--force-fForce re-run of specified steps (comma-separated)
--resumeResume interrupted run
--save-preferencesSave prompt answers
--dry-runPreview without executing
--env-eSet active environment (e.g., ci, staging)
--non-interactiveUse defaults, no prompts
--ciDeprecated: use --non-interactive and --env ci instead

Skip Behaviors

When using --skip, you can control how dependents are handled:

  • skip_with_dependents (default): Skip the step and all its dependents
  • skip_only: Skip only this step, attempt to run dependents
  • run_anyway: Don’t actually skip, run the step anyway

Examples

Run only database setup:

Terminal window
bivvy run --only=database

Skip seeds step:

Terminal window
bivvy run --skip=seeds

Force re-run of node_deps:

Terminal window
bivvy run --force=node_deps

Preview what would run:

Terminal window
bivvy run --dry-run

Run with a specific environment:

Terminal window
bivvy run --env staging

Non-interactive mode:

Terminal window
bivvy run --non-interactive

Run with a specific workflow:

Terminal window
bivvy run --workflow=production

Exit Codes

CodeMeaning
0All steps completed successfully
1One or more steps failed
2Configuration not found
130Interrupted (Ctrl+C)