Windsurf Adapter

The Windsurf adapter captures Cascade AI interactions in Windsurf (formerly Codeium).

Prerequisites

• Windsurf 1.7.0 or later
• FORG CLI installed and activated
• Windsurf extension API enabled (Settings → Advanced → Enable Extension API)

Installation

npm install -g @forg-pro/windsurf-adapter

Then register the plugin in Windsurf settings:

// ~/.windsurf/plugins.json
{
  "plugins": [
    {
      "name": "forg",
      "entry": "forg-windsurf-plugin",
      "config": {
        "projectId": "proj_my-windsurf-project"
      }
    }
  ]
}

Restart Windsurf after editing the plugin config.

What gets captured

• Cascade multi-step AI interactions (each step = one signal)
• Windsurf Chat messages
• Model, token counts, and latency per interaction

Not captured: Inline autocomplete calls, background context indexing, and Supercomplete events.

Known limitations

• Token counts are estimated; Windsurf does not expose exact token data via the plugin API
• Cost figures are approximations based on model pricing tables
• Multi-file Cascade flows may merge signals from distinct tool calls
• Windsurf Enterprise SSO users: plugin must be approved by org admin

Troubleshooting

# Check Windsurf plugin logs:
cat ~/.windsurf/logs/plugins/forg.log

# Verify FORG agent is running:
forg status