drenv

DragonRuby Environment Manager

curl -fsSL drenv.org/install.sh | bash

SIMPLE. RELIABLE. FAMILIAR.

drenv is the DragonRuby Environment Manager.

Multiple DragonRuby versions, global vs per-project, itch.io downloads, and painful PATH management — drenv solves all of it with a tiny, fast CLI that just works.

One-command installs

curl | bash installs the latest release and sets everything up.

Switch versions instantly

drenv global 3.4.0 and every new project uses the right runtime.

Works everywhere

macOS, Linux, and Windows. Full native support for PowerShell.

COMMAND REFERENCE

Key Commands

drenv installPRIMARY COMMAND

Downloads and installs the latest DragonRuby GTK directly from your itch.io account.

•First run securely prompts for your itch.io username/email and password. Credentials are stored in a local encrypted database (never sent anywhere else).

•Supports two-factor authentication (TOTP). If enabled, you'll be prompted for your 2FA code.

•Automatically selects the correct build for your platform (Apple Silicon / Intel macOS, Linux x64/arm64, Windows).

•Registers the downloaded version locally and sets it as your global default (if no global version is configured yet).

Usage

drenv install

Only the standard tier is supported at this time.

drenv register <path>

Manually register an existing DragonRuby installation from a .zip file or directory containing the dragonruby executable.

drenv global [version]

Set the global DragonRuby version used when creating new projects. Run without arguments to see the current global version.

drenv versions

List all installed DragonRuby versions. The active global version is marked with an asterisk (*).

drenv new <name>

Create a new DragonRuby project by copying the global version into a fresh directory.

drenv upgrade

Download and install the latest release of drenv itself.

Full source and additional details available on GitHub.