rb:runtime

Runtime Integration

Integrate with Tidewave Rails to enhance context with live system data from your running Rails application.

Prerequisites

Tidewave Rails must be installed in your project:

bundle add tidewave --group development

And ensure Tidewave is installed and connected to your Rails app.

Note: Runtime features require both:

1. Tidewave gem in your project
2. Tidewave MCP tools available in your Claude Code session

What Runtime Integration Provides

• Execute Ruby code in your running Rails app context
• Query database directly via SQL
• Fetch documentation for your exact gem versions
• Read application logs in real-time
• Introspect models and source locations
• Auto-capture errors during investigations

Detection

The detect-runtime.sh hook runs automatically at session start and detects:

# Detected from Gemfile:
TIDEWAVE_GEM_PRESENT=true
TIDEWAVE_PROJECT_CAPABLE=true

# Example subset persisted in .claude/.runtime_env for hook coordination:
HOOK_MODE=default
BETTERLEAKS_AVAILABLE=true
RTK_AVAILABLE=true

These values are persisted in ${REPO_ROOT}/.claude/.runtime_env as a sourceable cache of startup detection results. Contributor tooling and hooks may read or source that file when they want the cached values, but they are not automatically exported into every hook process environment and current hooks do not rely on it exclusively.

If Tidewave is not detected, runtime commands will provide setup guidance.

Commands

/rb:runtime inspect

Display runtime capability status:

/rb:runtime inspect

Shows:

• Tidewave gem detected in project
• MCP tool availability status
• Rails/Ruby version info

/rb:runtime execute <ruby-code>

Execute Ruby code in Rails console context:

/rb:runtime execute "User.recent.count"
/rb:runtime execute "Rails.application.config.active_job.queue_adapter"