Troubleshooting

Start with the built-in check. It tests Node, the API, your agent configs and your sign-in:

npx @vibefilo/mcp doctor

Vibefilo tools do not show up#

• Restart your agent after running init. Most agents only read MCP config at startup.
• Run doctor and confirm your agent is listed as configured.
• Check your Node version is 20.12 or newer.

The sign-in code expired#

Codes last 10 minutes. Call any Vibefilo tool again and approve the new code.

Results land in the wrong project#

Delete .vibefilo.json and ask your agent to set up Vibefilo for this project again.

Not enough credits#

Run a cheaper mode, or top up from Organization settings. See Modes and credits.

Could not reach Vibefilo#

• Check your internet connection and any proxy or firewall.
• If you set VIBEFILO_API_URL, make sure it is correct and reachable.

Contact support#

Visit the Support page or email support@vibefilo.dev, and include the output of doctor.