This page lists error cases directly surfaced by the server and tools.

Agent session already running

POST /_vibe-agent/prompt returns an error when a session is in progress:

• success: false
• message: "An agent session is already running. Please wait for it to finish or kill it before starting a new one."

Workspace not a git repository

Workspace operations return { error: "Not a git repository" } if git status fails.

MCP tool validation errors

The MCP server returns errors when required inputs are missing:

• shopId or pathname missing for MCP tools
• selector missing for analyze_css_selector
• selector missing when capture_screenshot uses what: "element"

IDE integration disabled

When VIBENV_IS_DOCKER is set, the Vibe server skips IDE integration setup.