Tidewave

Tidewave is the coding agent for full-stack web app development, deeply integrated with Rails, from the database to the UI. See our website for more information.

This project can also be used as a standalone Model Context Protocol server for your editors.

Installation

You can install Tidewave by adding the tidewave gem to the development group in your Gemfile:

gem "tidewave", group: :development

Now access /tidewave route of your web application to enjoy Tidewave Web!

Troubleshooting

Localhost requirement

Tidewave expects your web application to be running on localhost. If you are not running on localhost, you may need to set some additional configuration. In particular, you must configure Tidewave to allow allow_remote_access and optionally configure your Rails hosts. For example, in your config/environments/development.rb:

config.hosts << "company.local"
config.tidewave.allow_remote_access = true

If you want to use Docker for development, you either need to enable the configuration above or automatically redirect the relevant ports, as done by devcontainers. See our containers guide for more information.

Content security policy

If you have enabled Content-Security-Policy, Tidewave will automatically enable "unsafe-eval" under script-src in order for contextual browser testing to work correctly.

Web server requirements

At the moment, Tidewave requires all requests to be processed by the same process. In case Tidewave cannot connect to your application, consider starting your Rails application as follows:

RAILS_MAX_THREADS=1 WEB_CONCURRENCY=1 rails server

Production Environment

Tidewave is a powerful tool that can help you develop your web application faster and more efficiently. However, it is important to note that Tidewave is not meant to be used in a production environment.

Tidewave will raise an error if it is used in any environment where code reloading is disabled (which typically includes production).

Configuration

You may configure tidewave using the following syntax:

  config.tidewave.allow_remote_access = true

The following options are available:

• :allow_remote_access - Tidewave only allows requests from localhost by default, even if your server listens on other interfaces as well. If you trust your network and need to access Tidewave from a different machine, this configuration can be set to true

• :preferred_orm - which ORM to use, either :active_record (default) or :sequel

Acknowledgements

A thank you to Yorick Jacquin, for creating FastMCP and implementing the initial version of this project.

License

Copyright (c) 2025 Dashbit

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.