Tidewave for Rails is an AI-powered development assistant designed to accelerate web application development by integrating LLMs with the Rails runtime. It empowers developers to debug errors by inspecting application logs, execute SQL queries, evaluate Ruby code in context, and locate Rubygems packages directly from their editor.

How It Works

Tidewave leverages FastMCP to connect editor-based AI assistants to the Rails application runtime. This allows LLMs to interact with the application's environment, including logs, databases (supporting ActiveRecord and Sequel), and code, enabling context-aware assistance and debugging capabilities.

Quick Start & Requirements

• Install by adding gem "tidewave", group: :development to your Gemfile.
• Requires a threaded web server like Puma.
• Tidewave runs on the same port as the Rails application, with the MCP typically at http://localhost:3000/tidewave/mcp.
• Configuration options include allow_remote_access and preferred_orm.

Highlighted Details

• AI assistant understands application logs, database queries, and Ruby code context.
• Facilitates debugging and code exploration directly within the development workflow.
• Supports ActiveRecord and Sequel ORMs.

Maintenance & Community

• Initial version implemented by Yorick Jacquin.
• Project is under the Dashbit umbrella.

Licensing & Compatibility

• Licensed under the Apache License, Version 2.0.
• Permissive license suitable for commercial use and closed-source linking.

Limitations & Caveats

Tidewave is explicitly not intended for production environments and will raise an error if used as such. It requires a threaded web server like Puma.