What are the setup requirements for this skill?

You need to add the :tidewave dependency to your mix.exs, include the Tidewave plug in your endpoint.ex, and ensure debug annotations are enabled in your dev configuration.

How does this differ from using standard bash commands?

Unlike generic bash commands, Tidewave tools are environment-aware; for example, it fetches documentation specific to your project's library versions rather than the latest generic web docs.

Is Tidewave safe for production use?

No, Tidewave is strictly designed for local development environments and should never be used in production contexts or on shared servers containing production data.

Can I use this for LiveView debugging?

Yes, Tidewave allows you to inspect PIDs, socket assigns, and even evaluate browser-side state, making it highly effective for troubleshooting reactive LiveView components.

Tidewave MCP Integration for Phoenix

Name: Tidewave MCP Integration for Phoenix
Author: oliver-kriska

byoliver-kriska

•

Database Management

Provides real-time introspection and debugging tools for Elixir Phoenix applications via the Model Context Protocol (MCP).

Tidewave Integration bridges the gap between Claude Code and a running Phoenix application, allowing developers to execute Elixir code, query development databases via SQL, and inspect LiveView process states directly. By leveraging MCP runtime intelligence, it enables proactive error detection, precise documentation lookups for installed Hex versions, and automated smoke testing, ensuring that AI-generated code is immediately verified against the actual application state. This skill transforms Claude from a static code editor into an active runtime collaborator.

Key Features

01Direct SQL query execution for database schema inspection and verification

02Version-specific Hex documentation lookup tailored to your mix.lock

0362 GitHub stars

04Real-time Elixir code execution and evaluation within the project context

05LiveView state inspection and browser DOM evaluation for UI debugging

06Integrated log monitoring to automatically capture and analyze runtime errors

Use Cases

01Running automated smoke tests and behavioral checks immediately after code edits

02Debugging complex LiveView socket assigns and process states during feature development

03Verifying database migrations and schema changes without switching to a SQL client

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oliver-kriska/claude-elixir-phoenix tidewave-integration

For use in Claude.ai and ChatGPT

Download Skill