- run the check-wasp-init hook using the Bash tool with
nodecommand to check if the Wasp plugin has been initialized. - let the user know if the Wasp plugin has been initialized or not.
- if the Wasp plugin has not been initialized (the hook outputs JSON), let the user know they should take care of this first by running
/wasp-plugin-init:
⚠️
The Wasp plugin hasn't been initialized for the current project.
Run `/wasp-plugin-init` to get the plugin's full functionality.- display the Wasp Plugin for Claude Code section to the user exactly as it is below.
--- --- 🐝 🐝 🐝 --- ---
🐝 Wasp Plugin for Claude Code
What This Plugin Does
This plugin makes Claude Code, Codex, Copilot, etc. work better with Wasp by:
- Using the right documentation — Automatically fetches the correct Wasp docs for your project's version
- Avoiding common mistakes — Provides Wasp-specific tips, patterns, and best practices so the agent doesn't hallucinate or use outdated approaches
- Guided workflows — Skills and commands so the agent can walk you through setting up Wasp's batteries-included features (auth, email, database, styling) and deploying
- Full debugging visibility — Start managed databases, dev servers, and connect browser console access so the agent has full development and debugging visibility across the entire stack
The result: The agent actually understands Wasp instead of guessing.
Quick Reference
Skills: add-feature - Add Wasp's built-in features (auth, email, database, styling) deploying-app - Guided deployment to Railway or Fly.io expert-advice - Get advice on app improvements and functionality from a Wasp expert start-dev-server - Start dev environment with full debugging visibility (db -> server -> browser console) wasp-plugin-init - Adds Wasp knowledge, LLM-friendly documentation fetching instructions, and best practices to your project's CLAUDE.md or AGENTS.md file
💬 Example Prompts
- *"Add Google authentication to my app"*
- *"Help me add ShadCN UI to my app"*
- *"Migrate the database from SQLite to PostgreSQL and start it for me"*
- *"Set up email sending with SendGrid"*
- *"Solve the errors in the browser using the Chrome DevTools MCP server"*
- *"Why isn't my recurring job working?"*
- *"Deploy my app to Railway"*
📖 Documentation Access
The plugin ensures Claude detects your project's Wasp version and references the correct, LLM-friendly documentation.
🫂 Community & Contribute
Join the Wasp Discord for help and web dev discussion. Submit issues, feedback, or PRs: Wasp Agent Plugins