Install

Quick start

One-click install (recommended - macOS only):

curl -fsSL https://wlfi.sh | bash

To install the latest version explicitly, or pin a specific release:

# latest
curl -fsSL https://wlfi.sh/latest | bash

# specific version
curl -fsSL https://wlfi.sh/0.1.0 | bash

The script downloads a prebuilt runtime bundle, installs agentpay, and auto-detects supported AI host integrations (Codex, OpenClaw, Claude Code, Cursor). No Rust, Cargo, or pnpm required. After install, run agentpay admin setup to create a wallet.

Or install from source (requires Node.js 20+, pnpm, Rust 1.87.0+, and Xcode CLI Tools):

git clone https://github.com/worldliberty/agentpay-sdk.git
cd agentpay-sdk
pnpm install
pnpm run build
pnpm run install:cli-launcher
pnpm run install:rust-binaries

On macOS, add export PATH="$HOME/.agentpay/bin:$PATH" to ~/.zshrc, then reload your shell with source ~/.zshrc.

On Linux, add export PATH="$HOME/.agentpay/bin:$PATH" to your shell startup file such as ~/.bashrc, ~/.zshrc, or ~/.profile, then reload that file or open a new shell.

Then set up the wallet:

agentpay admin setup

From here, continue to Wallet setup -> Funding -> Policy -> Transfers.

Prerequisites

One-click install

• macOS

• Network access to download installer assets

• Homebrew only when the machine does not already have Node.js 20+

The one-click installer downloads a prebuilt macOS runtime bundle. It installs Node 20+ locally when a compatible version is not already available.

Install from source

• macOS or Linux

• Node.js 20+

• pnpm

• Rust 1.87.0+ (rustup recommended)

• Xcode Command Line Tools on macOS (xcode-select --install)

pnpm run install:cli-launcher installs the agentpay launcher into ~/.agentpay/bin, and pnpm run install:rust-binaries installs the Rust runtime into the same directory.

Skill pack

The one-click installer auto-detects supported hosts and copies the skill pack for you. To install only the skill pack and adapters without the full runtime, pass --skills-only:

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

See Install the skill pack for what the script does and which hosts it supports.

If you installed from source or need to update the pack manually:

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

The source path is skills/agentpay-sdk/ inside the SDK repository checkout.

See Skill pack and Install the skill pack for details.

What's next

Step	Page
Machine-side install details	CLI and local daemon
Set up or reuse a wallet	Wallet setup
Fund the wallet	Funding
Configure spending limits	Policy