← All integrations

Windsurf + GNO

Windsurf plus your own reference material

gno mcp install --target windsurf registers GNO with the exact Bun and package entrypoint plus the active index, so Windsurf resolves the same workspace your terminal does. From there its assistant retrieves from your documents on demand rather than guessing from the open buffer.

Connects via
MCP server
Requires
Bun 1.3+ and one indexed folder
Data boundary
Corpus and index stay on your machine

Install

Connect Windsurf in one command.

gno mcp install --target windsurf
gno mcp status
gno query 'topic' --explain

What it unlocks

  • Retrieval over every collection you have indexed
  • Metadata filters for date, tag, category, author, and language
  • Explainable ranking when a result looks wrong

Prove it actually works

A written config file is not a working integration. GNO distinguishes the two, and so should you.

  • Run gno mcp status to confirm GNO is registered for the target.
  • Open the Connectors page in gno serve and run the explicit read-only retrieval check. It proves the configured client can actually retrieve, not just that a config file exists.
  • Ask the client something only your corpus knows. If it answers with a citation into your files, the wiring is real.

Keep reading

Related guides and features.