Using Xpolink with Windsurf

Add the Xpolink skill file to Windsurf's rules directory so the AI assistant can create and manage branded short links from your editor.

Prerequisites

  • A Xpolink account with an API key (generate one from your dashboard under Settings → API Keys)
  • Windsurf editor installed

Quick Setup

Two steps to get started:

  1. Download the skill file and move it into your project's .windsurf/rules/ folder
  2. When you ask Windsurf to use Xpolink, it will prompt you for your API key
Download xpolink-skill.md

Terminal Setup (Alternative)

If you prefer the terminal:

curl -o xpolink-skill.md https://xpolink.app/xpolink-skill.md
mkdir -p .windsurf/rules
mv xpolink-skill.md .windsurf/rules/

Windsurf automatically picks up rules files and uses them as context when you interact with the AI assistant.

Optionally, set your API key in advance:

echo 'export XPOLINK_API_KEY="xpo_your_key_here"' >> ~/.zshenv
source ~/.zshenv

Usage

Open the Windsurf AI chat and ask it to manage your links. The assistant will use the skill file as context to make the correct API calls:

"Create a short link for https://example.com/campaign"
"List my recent short links"
"Delete link abc123"

Example Workflow

You: Shorten https://example.com/blog/post-42 with slug "post42"

Windsurf runs:
curl -s -X POST https://xpolink.app/api/v1/links   -H "Authorization: Bearer $XPOLINK_API_KEY"   -H "Content-Type: application/json"   -d '{"url": "https://example.com/blog/post-42", "shortCode": "post42"}'

Result: https://xpo.link/post42

See the API documentation and CLI documentation for the full reference. Questions? Contact us.