run402 1.0.0 → 1.2.0
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.
- package/README.md +116 -0
- package/package.json +4 -10
package/README.md
ADDED
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
# run402 CLI
|
|
2
|
+
|
|
3
|
+
Command-line interface for [Run402](https://run402.com) — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 micropayments.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g run402
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
Or run without installing:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npx run402 <command>
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Getting Started
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
# 1. Create a local wallet
|
|
21
|
+
run402 wallet create
|
|
22
|
+
|
|
23
|
+
# 2. Fund it with test USDC (Base Sepolia faucet)
|
|
24
|
+
run402 wallet fund
|
|
25
|
+
|
|
26
|
+
# 3. Deploy your app
|
|
27
|
+
run402 deploy --tier prototype --manifest app.json
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Commands
|
|
31
|
+
|
|
32
|
+
### `run402 wallet`
|
|
33
|
+
|
|
34
|
+
Manage your local x402 wallet.
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
run402 wallet create # Generate a new wallet
|
|
38
|
+
run402 wallet status # Show address, network, funding status
|
|
39
|
+
run402 wallet fund # Request test USDC from the faucet
|
|
40
|
+
run402 wallet export # Print wallet address (for scripting)
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
### `run402 deploy`
|
|
44
|
+
|
|
45
|
+
Deploy a full-stack app or static site.
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
run402 deploy --tier prototype --manifest app.json
|
|
49
|
+
run402 deploy --tier hobby --manifest app.json
|
|
50
|
+
cat app.json | run402 deploy --tier team
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
**Tiers:** `prototype` | `hobby` | `team`
|
|
54
|
+
|
|
55
|
+
**Manifest format:**
|
|
56
|
+
```json
|
|
57
|
+
{
|
|
58
|
+
"name": "my-app",
|
|
59
|
+
"files": {
|
|
60
|
+
"index.html": "<html>...</html>",
|
|
61
|
+
"style.css": "body { margin: 0; }"
|
|
62
|
+
},
|
|
63
|
+
"env": {
|
|
64
|
+
"MY_VAR": "value"
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### `run402 projects`
|
|
70
|
+
|
|
71
|
+
Manage your deployed projects.
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
run402 projects list # List all projects
|
|
75
|
+
run402 projects sql <id> "SELECT * FROM users" # Run SQL query
|
|
76
|
+
run402 projects rest <id> users "limit=10" # REST API query
|
|
77
|
+
run402 projects usage <id> # Compute/storage usage
|
|
78
|
+
run402 projects schema <id> # Database schema
|
|
79
|
+
run402 projects renew <id> # Extend lease (pays via x402)
|
|
80
|
+
run402 projects delete <id> # Delete project
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### `run402 image`
|
|
84
|
+
|
|
85
|
+
Generate AI images via x402 micropayments.
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
run402 image generate "a startup mascot, pixel art"
|
|
89
|
+
run402 image generate "futuristic city at night" --aspect landscape
|
|
90
|
+
run402 image generate "portrait of a cat CEO" --aspect portrait --output cat.png
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
**Options:** `--aspect square|landscape|portrait` · `--output <file>`
|
|
94
|
+
|
|
95
|
+
## Help
|
|
96
|
+
|
|
97
|
+
Every command supports `--help` / `-h`:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
run402 --help
|
|
101
|
+
run402 wallet --help
|
|
102
|
+
run402 deploy --help
|
|
103
|
+
run402 projects --help
|
|
104
|
+
run402 image --help
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## Notes
|
|
108
|
+
|
|
109
|
+
- Wallet stored at `~/.run402/wallet.json`
|
|
110
|
+
- Project credentials stored at `~/.run402/projects.json`
|
|
111
|
+
- Network: Base Sepolia (testnet) — USDC for x402 payments
|
|
112
|
+
- Payments are handled automatically — no manual signing required
|
|
113
|
+
|
|
114
|
+
## License
|
|
115
|
+
|
|
116
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "run402",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 micropayments.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
|
-
"run402": "cli.mjs"
|
|
7
|
+
"run402": "./cli.mjs"
|
|
8
8
|
},
|
|
9
9
|
"files": [
|
|
10
10
|
"cli.mjs",
|
|
@@ -22,14 +22,8 @@
|
|
|
22
22
|
"homepage": "https://run402.com",
|
|
23
23
|
"repository": {
|
|
24
24
|
"type": "git",
|
|
25
|
-
"url": "
|
|
25
|
+
"url": "https://github.com/kychee-com/run402.git",
|
|
26
26
|
"directory": "cli"
|
|
27
27
|
},
|
|
28
|
-
"keywords": [
|
|
29
|
-
"run402",
|
|
30
|
-
"x402",
|
|
31
|
-
"postgres",
|
|
32
|
-
"ai-agent",
|
|
33
|
-
"openclaw"
|
|
34
|
-
]
|
|
28
|
+
"keywords": ["run402", "x402", "postgres", "ai-agent", "openclaw"]
|
|
35
29
|
}
|