pay-cli 0.2.8

CLI for pay — payment infrastructure for AI agents
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# pay

Command-line tool for [pay](https://pay-skill.com) — payment infrastructure for AI agents. USDC on Base.

## Install

```bash
cargo install pay-cli
```

## Setup

```bash
pay init          # Create ~/.pay/config.toml
pay status        # Check balance and open tabs
```

## Commands

### Direct Payment

Send a one-shot USDC payment. $1.00 minimum.

```bash
pay direct 0xprovider... 5.00
pay direct 0xprovider... 1.50 --memo "task-42"
```

### Tab Management

Open, charge, top up, and close pre-funded metered tabs. $5.00 minimum to open.

```bash
pay tab open 0xprovider... 20.00 --max-charge 0.50
pay tab list
pay tab topup tab_abc123 10.00
pay tab close tab_abc123
```

Provider-side charging:

```bash
pay tab charge tab_abc123 0.30
```

### x402 Requests

Make HTTP requests that automatically handle 402 Payment Required responses.

```bash
pay request https://api.example.com/data
```

The CLI detects 402 responses, pays via direct or tab settlement, and retries.

### Webhooks

```bash
pay webhook register https://myapp.com/hooks
pay webhook list
pay webhook delete wh_abc123
```

### Signer

The `pay sign` command acts as a signing subprocess for SDKs. It reads a hex-encoded hash from stdin and writes the signature to stdout.

```bash
echo "deadbeef..." | pay sign
```

Private key is loaded from the `PAYSKILL_SIGNER_KEY` environment variable.

### Funding

```bash
pay fund                              # Open Coinbase Onramp funding page
pay withdraw 0xrecipient... 50.00     # Get withdrawal link
```

## Global Flags

| Flag | Env Var | Purpose |
|------|---------|---------|
| `--json` | — | Output JSON instead of human-readable format |
| `--api-url` | `PAYSKILL_API_URL` | Override API URL (default: `https://pay-skill.com/api/v1`) |

## Configuration

Config file: `~/.pay/config.toml`

```toml
api_url = "https://pay-skill.com/api/v1"
testnet = false
```

| Env Var | Purpose |
|---------|---------|
| `PAYSKILL_API_URL` | Override API URL |
| `PAYSKILL_SIGNER_KEY` | Private key for `pay sign` |

## Command Reference

```
pay init                              First-time setup
pay status                            Balance + open tabs
pay direct <to> <amount>              Send USDC ($1 min)
pay tab open <provider> <amount>      Open tab ($5 min)
  --max-charge <amount>               Max per-charge limit
pay tab charge <tab_id> <amount>      Charge a tab (provider-side)
pay tab close <tab_id>                Close a tab
pay tab topup <tab_id> <amount>       Add funds to open tab
pay tab list                          List open tabs
pay request <url>                     x402 request (auto-pay)
  -X <METHOD>                          HTTP method (default: GET, POST if -d)
  -H "Key: Value"                      Add header (repeatable)
  -d <body>                            Request body (@file reads from file)
  -o <file>                            Write response to file
  -v / -s                              Verbose / silent
  --no-pay                             Skip x402 payment handling
pay webhook register <url>            Register webhook endpoint
pay webhook list                      List registered webhooks
pay webhook delete <id>               Remove a webhook
pay sign                              Signer subprocess (stdin/stdout)
pay fund                              Open funding page
pay withdraw <to> <amount>            Withdraw USDC
```

## License

MIT