@masukomi/pi-rbenv

A pi extension package that automatically manages and sets your Ruby version using rbenv.

It intercepts all subprocess commands, interactive user bash executions (!/!!), and core pi tool calls to ensure that they are executed under the correct Ruby version with the appropriate environment variables and PATH adjustments.

Features

• Dynamic Ruby Version Resolution: Automatically reads and respects .ruby-version files in the project root.
• Graceful Fallbacks: Falls back to rbenv's global Ruby version if a project's requested version is not installed or if no .ruby-version is found.
• Subprocess Integration: Pre-pends rbenv shims to the environment PATH across all subprocess commands.
• Tool Interception: Automatically injects the correct RBENV_VERSION and PATH into the built-in bash tool, ctx_shell, and user_bash (!/!!) sessions. Note: ctx_shell is part of pi-lean-ctx
• Startup Notification: Shows a neat notification when the session starts telling you exactly which Ruby version is active and if a warning/fallback is in effect.

Installation

Local Installation (for development or private use)

Run the following command inside your project directory, or point to the absolute path of this package:

pi install /path/to/pi-rbenv

Git Installation

pi install git:github.com/masukomi/pi-rbenv

npm Installation

pi install npm:@masukomi/pi-rbenv

How It Works

1. On Session Start: Checks if there is a .ruby-version file in the project directory. If present, it verifies whether the requested version is installed under rbenv.
2. Environment Tuning: If the requested version is present, it sets RBENV_VERSION to that version. If not, it falls back to the default/global rbenv version and displays a warning notification in the TUI/CLI.
3. Subprocess/Tool Overriding:
   • Overrides the built-in bash tool to ensure it runs with the modified environment.
   • Intercepts the shell/ctx_shell tools to export the proper PATH and RBENV_VERSION variables before command execution.
   • Wraps the interactive user CLI command runner (!/!!) to preserve active rbenv settings.

License

MIT