Using Xpolink with Codex

Drop the Xpolink skill file into your project and set your API key. Codex picks it up as context and can manage your short links.

Prerequisites

  • A Xpolink API key (generate one from your dashboard under Settings → API Keys)
  • Codex CLI installed (npm install -g @openai/codex)

Quick Setup

Two steps to get started:

  1. Download the skill file and save it as XPOLINK.md in your project root
  2. Set your API key: export XPOLINK_API_KEY="xpo_your_key"

Codex automatically reads project files for context and will use the skill file when you ask it to manage links.

Download XPOLINK.md

Terminal Setup (Alternative)

curl -o XPOLINK.md https://xpolink.app/xpolink-skill.md
echo 'export XPOLINK_API_KEY="xpo_your_key_here"' >> ~/.zshenv
source ~/.zshenv

Usage

Ask Codex to manage your links in plain English:

codex "Create a Xpolink short link for https://example.com/docs"

codex "List my Xpolink short links"

codex "Show click stats for my most recent Xpolink link"

codex "Delete Xpolink link abc123"

Example Workflow

$ codex "Shorten https://example.com/launch with slug launch"

Running: 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/launch","shortCode":"launch"}'

Created: https://xpol.app/launch

For the full API reference, see the API documentation. Questions? Contact us.