Agent CLI

# Agent installs once
./my-service-darwin-arm64 --install
# → { "installed": "/Users/alice/.local/bin/my-service", "inPath": true }

# Then uses it from anywhere
my-service discover
my-service request --plan basic

bun add @key0ai/key0

import { buildCli } from "@key0ai/key0/cli";

const result = await buildCli({
  name: "my-service",
  url: process.env.KEY0_PUBLIC_URL ?? "https://api.example.com",

  // Cross-compile for all platforms your agents run on.
  // Omit targets (or pass []) to build for the current platform only.
  targets: ["bun-linux-x64", "bun-darwin-arm64", "bun-darwin-x64"],

  outputDir: "./dist/cli",
});

for (const bin of result.binaries) {
  const mb = (bin.size / 1024 / 1024).toFixed(1);
  console.log(`✓ ${bin.path}  (${mb} MB)`);
}

bun run build-cli.ts
# ✓ ./dist/cli/my-service-linux-x64  (63.2 MB)
# ✓ ./dist/cli/my-service-darwin-arm64  (57.9 MB)
# ✓ ./dist/cli/my-service-darwin-x64  (66.1 MB)

# 1. Download the binary for your platform
curl -fsSL https://cdn.example.com/cli/my-service-darwin-arm64 -o my-service
chmod +x ./my-service

# 2. Self-install to PATH
./my-service --install
# → { "installed": "/Users/alice/.local/bin/my-service", "inPath": true, "addToPath": "export PATH=\"/Users/alice/.local/bin:$PATH\"" }

export PATH="/Users/alice/.local/bin:$PATH"

sudo ./my-service --install

# Discover available plans and pricing
my-service discover

# Request access to a plan (returns 402 challenge or access grant)
my-service request --plan basic

# Request with a payment signature (from payments-mcp)
my-service request --plan basic --payment-signature <base64-payload>

# Show help
my-service --help

# Show version and URL
my-service --version

// discover
{ "agentName": "My Service", "plans": [{ "planId": "basic", "unitAmount": "$0.10" }] }

// request (payment required)
{ "challengeId": "abc123", "amount": "100000", "destination": "0x...", "chainId": 84532 }

// request (access granted)
{ "token": "eyJ...", "resourceUrl": "https://api.example.com/resource/default" }

# Claude discovers the service, downloads the right binary, and installs it
curl -fsSL https://cdn.example.com/cli/my-service-darwin-arm64 -o my-service
chmod +x ./my-service
./my-service --install

# Discover plans
my-service discover

# Request access (will return 402 with payment challenge)
my-service request --plan basic

# After paying via payments-mcp, submit the signature
my-service request --plan basic --payment-signature <sig>

# Use the returned token to call the API
curl -H "Authorization: Bearer <token>" https://api.example.com/resource/default