# Windsurf

Windsurf doesn't yet have a first-class skill installer, so the lightest path is to point Cascade at our full documentation as a single context file.

## Install[​](#install "Direct link to Install")

Add `llms.txt` as a context source in Windsurf:

1. Open Windsurf settings → **Cascade** → **Context**.
2. Add a new URL context source: `https://docs.ideal-postcodes.co.uk/llms.txt`.
3. Save. Cascade will pull the file on each session.

`llms.txt` is the full API reference, integration guides, and widget docs concatenated into one file — about the right size for a context source.

## Verify[​](#verify "Direct link to Verify")

In a fresh Cascade session:

```
What's the difference between Address Finder and Postcode Lookup?
```

The reply should reference both products by name and explain UK-only vs. multi-country.

## API key[​](#api-key "Direct link to API key")

* Quick test: `ak_test` (capped at 5 lookups/day, public, breaks in production).
* Real key: [sign up](https://ideal-postcodes.co.uk/signup) for a free trial balance.
* Before deploy: restrict the key via [Allowed URLs](/docs/guides/allowed-urls.md).

## Going deeper[​](#going-deeper "Direct link to Going deeper")

* Per-page markdown: append `.md` to any docs URL (e.g. [`/docs/address-finder.md`](https://docs.ideal-postcodes.co.uk/docs/address-finder.md)) when you want one specific page instead of the whole file.
* Full agent hub: [Build with AI](/docs/guides/llms.md)

## Need help?[​](#need-help "Direct link to Need help?")

* File an issue: [github.com/ideal-postcodes/feedback](https://github.com/ideal-postcodes/feedback/issues)
* Email: <support@ideal-postcodes.co.uk>