Codeium · Windsurf
Publish what Windsurf makes
When Windsurf turns out a report, a deck or a web page, freo.cloud is where it lands. Ask Windsurf to publish and share, and pick how it goes out — public, a unique link, email-protected, or an allowlist of named people. The link stays yours to change or retire.
Connect Windsurf in four steps
-
01
Sign in with your email
No passwords — a magic link drops you into your own
@handlespace. -
02
Copy your setup prompt
From your Connect page — it's one-time and expires. Your key never appears in any URL.
-
03
Paste it into Windsurf
Windsurf claims your private publishing key and saves the publishing skill itself. Works on macOS, Linux and Windows.
-
04
Just ask it to publish
“Publish this report.” “Share these numbers with Angela — just her.” Windsurf figures out the file and the audience and hands you back the link.
Prefer MCP? Windsurf speaks it natively
Add the server to ~/.codeium/windsurf/mcp_config.json, with a key from your Connect page:
{
"mcpServers": {
"freo": {
"serverUrl": "https://freo.cloud/mcp",
"headers": { "Authorization": "Bearer YOUR_FREO_TOKEN" }
}
}
}
Same access controls, same link back — skill or MCP, your pick. Full walkthrough on the MCP server page.
Questions
Does freo.cloud work with Windsurf?
Yes. Windsurf publishes to freo.cloud through a small skill you install by pasting one prompt — no plugin, no build step. It works on macOS, Linux and Windows. Prefer a connector? Windsurf can also connect over freo's MCP server.
Do I need to know how to code?
No. You paste one prompt into Windsurf once, then talk to it in plain language — “publish this,” “share it with Sam.” Windsurf does the upload and hands you the link.
Do I need to install anything?
No. You choose where the skill should live, then paste a single setup prompt into Windsurf; it claims your private publishing key and saves the publishing skill itself. After that you just ask it to publish.
Can Windsurf read my other documents or my account?
The key is scoped to your documents — it can publish and manage what you publish (create, read, update, re-share, remove), but it cannot change your account settings, sign in as you, or reach anyone else's space. It expires and you can revoke it any time.
Is it free?
Yes — freo.cloud is free during early access.
Ready to publish from Windsurf?
Sign in with your email and you'll have your space — and your setup prompt — in seconds.
Get your space →