Install the skill pack

This page shows how to install the AgentPay SDK skill pack into a supported host.

The most important detail is this:

• the host loads the skill pack

• the local machine still runs agentpay

Do not treat those as the same install step.

Quick install (skills only)

If you only want the AI skill pack and adapters without installing the local AgentPay runtime:

curl -fsSL https://wlfi.sh | bash -s -- --skills-only

You can also pin a version:

curl -fsSL https://wlfi.sh/latest | bash -s -- --skills-only
curl -fsSL https://wlfi.sh/0.1.0 | bash -s -- --skills-only

This mode:

• downloads the same macOS AgentPay bundle used by the full installer and only applies the embedded skill files

• auto-detects supported AI agent paths and already-installed destinations

• presents a toggleable target list and lets you add custom skill-pack or adapter destinations

• supports Codex, Claude, Cline, Goose, Windsurf, OpenClaw, portable/legacy .agents, Cursor, and workspace adapters (AGENTS.md, CLAUDE.md, GEMINI.md, Copilot instructions)

• installs the Cursor adapter when AGENTPAY_SETUP_CURSOR_WORKSPACE is set or the current directory is already a Cursor workspace

• does not install agentpay, Node.js, shell PATH exports, or wallet runtime files

After the script finishes, skip to After install to verify.

The sections below cover manual installation for operators who installed from source or need to copy files to a custom location.

What the skill pack contains

The skill pack folder includes:

• SKILL.md - the main skill definition loaded by compatible hosts

• agents/ - host adapter files (AGENTS.md for Codex/OpenClaw, CLAUDE.md for Claude Code, cursor-agentpay-sdk.mdc for Cursor, openai.yaml for OpenAI-compatible hosts)

• references/ - the playbooks the agent host actually follows:

  • capabilities.md - what the SDK can and cannot do

  • install-and-workflows.md - setup, funding, and transfer recipes

  • intents-and-policies.md - intent mapping and policy configuration

• scripts/ - helper scripts for agent-driven workflows:

  • prepare-funding-request.mjs - generates funding instructions, QR codes, and formatted output for wallet top-up requests

  • vendor/qrcodegen.mjs - QR code generation library used by the funding request script

Operators should review the files in references/ to understand what their agent host is doing on their behalf.

What you copy

Clone the repository if you have not already:

git clone https://github.com/worldliberty/agentpay-sdk.git

The skill pack is the skills/agentpay-sdk/ folder inside the checkout. Do not copy the whole repository into the host's skills directory.

If you reinstall or update the pack, replace the existing destination folder instead of copying into it repeatedly.

Codex

mkdir -p ~/.codex/skills
cp -R agentpay-sdk/skills/agentpay-sdk ~/.codex/skills/

OpenClaw

mkdir -p ~/.openclaw/skills
cp -R agentpay-sdk/skills/agentpay-sdk ~/.openclaw/skills/

Claude Code

mkdir -p ~/.claude/skills
cp -R agentpay-sdk/skills/agentpay-sdk ~/.claude/skills/

Cursor

Cursor has a purpose-built .mdc adapter file. Use it instead of AGENTS.md:

cp agentpay-sdk/skills/agentpay-sdk/agents/cursor-agentpay-sdk.mdc ./.cursor/rules/agentpay-sdk.mdc

The .mdc file includes alwaysApply: false front-matter so Cursor only invokes it when relevant.

After install

Open a new host session and try:

What can you do with AgentPay SDK?

A correct install should let the host speak concretely about wallet setup, funding, policy, transfers, and approvals without needing extra pasted instructions.

Next step

With the skill pack installed, continue to Workflows for the end-to-end operator flow.