Windsurf

Windsurf is Cognition's agentic IDE (acquired by Cognition, the makers of Devin, in late 2025). It talks to VibeHost two ways: through our MCP server (interactive, OAuth) or via the vibehost CLI wrapped as a tool (scripted, PAT).

Option 1: MCP server (recommended for interactive use)

Open Windsurf settings → Cascade → Plugins → Add MCP Server → custom server. Add this entry to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vibehost": {
      "serverUrl": "https://api.vibehost.com/mcp"
    }
  }
}

Save. Windsurf reloads the config. First tool call opens your browser for OAuth; after approval, Cascade has the full VibeHost tool surface — deploy, promote, rollback, list logs, manage custom domains.

In a Cascade session, just describe what you want:

Deploy this directory to VibeHost as a new app called my-windsurf-app.

Cascade picks the right tools (create_app + create_deployment) and returns the live URL.

Option 2: CLI as a tool (recommended for scripts and CI)

Install the CLI:

curl -fsSL https://vibehost.com/install.sh | sh

Authenticate with a Personal Access Token:

export VIBEHOST_TOKEN=$(pass vibehost/pat)
vibehost whoami --json

Cascade can now call vibehost deploy ./dist etc. through its terminal-tool interface. Every command takes --json and returns {ok, data | error} for clean agent parsing — see the CLI reference.

When to pick which

Both can coexist.

See also

• MCP server — full tool list + auth details
• Personal access tokens — PAT setup for CI / scripts
• Sibling coding agents: Claude Code, Codex CLI, Cursor, Antigravity, OpenCode, Copilot CLI, Gemini CLI, Hermes Agent