@clawcard/cli 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +79 -14
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # @clawcard/cli
2
2
 
3
- On-demand credit cards, email, and phone for your AI agents.
3
+ The complete identity for autonomous AI agents.
4
4
 
5
- ClawCard gives your agent a full identity — dedicated email inbox, SMS-enabled US phone number, virtual Mastercards with spend limits, and an encrypted credential vault. Your agent interacts with ClawCard through CLI commands — the API key never enters the agent's context.
5
+ One command gives your agent email, phone, virtual cards, a USDC crypto wallet, on-chain identity, and access to every paid API on the internet. Works with Claude Code, Cursor, Gemini CLI, and any MCP-compatible agent.
6
6
 
7
7
  ## Install
8
8
 
@@ -26,28 +26,81 @@ clawcard keys create
26
26
  clawcard setup
27
27
  ```
28
28
 
29
- `clawcard setup` uses [skills.sh](https://skills.sh) to install the ClawCard skill for your agent. Works with Claude Code, Cursor, Codex, Cline, OpenClaw, and 40+ other agents.
29
+ `clawcard setup` uses [skills.sh](https://skills.sh) to install the ClawCard skill for your agent.
30
+
31
+ ## What Your Agent Gets
32
+
33
+ | Capability | Description |
34
+ |---|---|
35
+ | Email | Dedicated inbox at `@mail.clawcard.sh` |
36
+ | Phone | SMS-enabled US phone number |
37
+ | Virtual Cards | Instant Visa cards with per-card spend limits |
38
+ | Crypto Wallet | USDC on Base — gasless transfers, x402 + MPP payments |
39
+ | Service Discovery | Find and pay for any API in the x402 ecosystem |
40
+ | On-Chain Identity | ERC-8004 NFT — verifiable, portable agent identity |
41
+ | Credentials | AES-256 encrypted vault for API keys and secrets |
42
+ | Spending Guardrails | Per-agent, per-transaction, per-day limits |
30
43
 
31
44
  ## Agent Commands
32
45
 
33
46
  Your agent runs these commands directly. All support `--json` for machine-parseable output.
34
47
 
48
+ ### Identity & Info
49
+
50
+ | Command | Description |
51
+ |---|---|
52
+ | `clawcard agent info --json` | Agent identity (email, phone, wallet, budget) |
53
+ | `clawcard agent budget --json` | Check remaining FIAT budget |
54
+ | `clawcard agent activity --json` | View activity log |
55
+
56
+ ### Communication
57
+
35
58
  | Command | Description |
36
59
  |---|---|
37
- | `clawcard agent info --json` | Agent identity (email, phone, budget) |
38
60
  | `clawcard agent emails --json` | List inbox |
39
61
  | `clawcard agent emails send --to --subject --body --json` | Send email |
40
62
  | `clawcard agent sms --json` | List SMS messages |
41
63
  | `clawcard agent sms send --to --body --json` | Send SMS |
64
+
65
+ ### Virtual Cards (FIAT)
66
+
67
+ | Command | Description |
68
+ |---|---|
42
69
  | `clawcard agent cards --json` | List virtual cards |
43
70
  | `clawcard agent cards create --amount --type --memo --json` | Create card |
44
71
  | `clawcard agent cards details <id> --json` | Get PAN, CVV, expiry |
45
72
  | `clawcard agent cards close <id> --json` | Close card |
73
+
74
+ ### Crypto Wallet (USDC on Base)
75
+
76
+ | Command | Description |
77
+ |---|---|
78
+ | `clawcard agent wallet --json` | View wallet (or create one) |
79
+ | `clawcard agent wallet balance --json` | Balance + spending power |
80
+ | `clawcard agent wallet fund --amount <dollars> --json` | Fund wallet from FIAT balance |
81
+ | `clawcard agent wallet send --to <0x> --amount <usdc> --json` | Send USDC |
82
+ | `clawcard agent wallet send --url <url> --json` | Pay an x402 API |
83
+ | `clawcard agent wallet send --url <url> --protocol mpp --json` | Pay an MPP API |
84
+ | `clawcard agent wallet transactions --json` | Transaction history |
85
+ | `clawcard agent wallet freeze --json` | Freeze wallet |
86
+ | `clawcard agent wallet unfreeze --json` | Unfreeze wallet |
87
+ | `clawcard agent wallet close --json` | Close wallet permanently |
88
+
89
+ ### Discovery & Identity
90
+
91
+ | Command | Description |
92
+ |---|---|
93
+ | `clawcard agent discover --query "web search" --json` | Find x402 services |
94
+ | `clawcard agent identity --json` | Register/view ERC-8004 on-chain identity |
95
+ | `clawcard agent card --json` | View A2A agent card (discovery document) |
96
+
97
+ ### Credentials
98
+
99
+ | Command | Description |
100
+ |---|---|
46
101
  | `clawcard agent creds --json` | List stored credentials |
47
102
  | `clawcard agent creds set --service --key --value --json` | Store credential |
48
103
  | `clawcard agent creds get --service --key --json` | Retrieve credential |
49
- | `clawcard agent budget --json` | Check remaining budget |
50
- | `clawcard agent activity --json` | View activity log |
51
104
 
52
105
  ## User Commands
53
106
 
@@ -60,33 +113,45 @@ Your agent runs these commands directly. All support `--json` for machine-parsea
60
113
  | `clawcard agent` | Show agent identity |
61
114
  | `clawcard agent fund` | Add budget to your agent |
62
115
  | `clawcard keys create` | Create agent key |
63
- | `clawcard keys revoke` | Revoke key (exports credentials first) |
116
+ | `clawcard keys revoke` | Revoke key |
64
117
  | `clawcard setup` | Install ClawCard skill |
65
118
  | `clawcard billing` | Billing dashboard |
66
119
  | `clawcard billing topup` | Top up balance |
67
120
  | `clawcard billing balance` | Quick balance check |
68
121
  | `clawcard referral` | Show referral code |
122
+ | `clawcard settings` | Manage billing address |
69
123
  | `clawcard help` | Show all commands |
70
124
 
71
125
  ## How It Works
72
126
 
73
- 1. You create an agent key via the CLI — it gets an email, phone number, and budget
74
- 2. `clawcard setup` installs a skill file that teaches your agent the available commands
75
- 3. Your agent runs `clawcard agent` commands to send emails, create cards, store credentials, etc.
76
- 4. The API key stays in `~/.clawcard/.env` — the agent never sees it
127
+ 1. You create an agent key — it gets email, phone, and budget
128
+ 2. `clawcard setup` installs the skill that teaches your agent the commands
129
+ 3. Agent creates a wallet, discovers services, pays for APIs, signs up for things
130
+ 4. Everything is logged — full audit trail in the dashboard
131
+ 5. You control the budget and can freeze/close anything instantly
132
+
133
+ ## Payment Protocols
134
+
135
+ ClawCard is the first platform to unify both major machine payment protocols:
136
+
137
+ - **x402** (Coinbase) — Pay-per-request API payments with USDC. 50M+ transactions.
138
+ - **MPP** (Stripe/Tempo) — Session-based machine payments. Cards, stablecoins, Lightning.
139
+
140
+ Your agent pays for any service in either ecosystem. You never think about protocols.
77
141
 
78
142
  ## Pricing
79
143
 
80
144
  Pay as you go. No subscriptions, no monthly fees.
81
145
 
82
146
  - **Minimum top-up** — $5
83
- - **Processing fee** — 10%
147
+ - **Processing fee** — 10% on FIAT top-ups
148
+ - **Wallet funding fee** — 2% on FIAT-to-USDC conversion
84
149
  - **Cards** — Unlimited
85
-
86
- Top up your balance and your agent spends it on virtual cards.
150
+ - **x402/MPP payments** — Pay source price (no markup)
87
151
 
88
152
  ## Links
89
153
 
90
154
  - [Website](https://clawcard.sh)
91
155
  - [Docs](https://clawcard.sh/docs)
92
156
  - [Skill](https://github.com/latchagent/skill)
157
+ - [Dashboard](https://clawcard.sh/dashboard)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clawcard/cli",
3
- "version": "3.0.0",
3
+ "version": "3.0.1",
4
4
  "description": "The ClawCard CLI — manage your agent keys, billing, and setup from the terminal",
5
5
  "bin": {
6
6
  "clawcard": "./bin/clawcard.mjs"