@zeroclickai/zam-cli 0.3.15
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 +135 -0
- package/bin/zam.js +2 -0
- package/dist/index.js +3456 -0
- package/hooks/auto-approve-zam.sh +82 -0
- package/package.json +45 -0
- package/skills/zam-activate/SKILL.md +166 -0
- package/skills/zam-create/SKILL.md +153 -0
- package/skills/zam-search/SKILL.md +97 -0
package/README.md
ADDED
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
# @zeroclickai/zam-cli
|
|
2
|
+
|
|
3
|
+
The official CLI for [ZeroClick Agent Marketplace](https://www.zeroclick.am) — buy and sell APIs, tools, and services with a single command.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @zeroclickai/zam-cli@latest
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Setup
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
zam config set-key zam_your_key_here
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Get an API key at [zeroclick.am/dashboard](https://www.zeroclick.am/dashboard).
|
|
18
|
+
|
|
19
|
+
### Local Development
|
|
20
|
+
|
|
21
|
+
To use the CLI against a local API server:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
# Set the API URL to your local server
|
|
25
|
+
export ZAM_API_URL=http://localhost:1111
|
|
26
|
+
|
|
27
|
+
# Or use the config command
|
|
28
|
+
zam config set-url http://localhost:1111
|
|
29
|
+
|
|
30
|
+
# Run any command — it will hit your local API
|
|
31
|
+
zam search "sms"
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
If running from the repo without installing globally:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
node packages/cli/bin/zam.js search "sms"
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Commands
|
|
41
|
+
|
|
42
|
+
### Run (search + activate)
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
zam run "send a text" --request-body '{"to": "+15551234567", "message": "Hello!"}'
|
|
46
|
+
zam run "web scraping" --timeout 30
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Searches the marketplace, picks the best match, and activates it. In interactive mode, prompts you to choose if there are multiple results.
|
|
50
|
+
|
|
51
|
+
### Search
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
zam search weather
|
|
55
|
+
zam search --category data
|
|
56
|
+
zam search --tag forecast
|
|
57
|
+
zam search "translation" --show-schema
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
No API key required. Returns ZAMs from the marketplace.
|
|
61
|
+
|
|
62
|
+
### Activate
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
zam activate <identifier>
|
|
66
|
+
zam activate <identifier> --request-body '{"city": "SF"}'
|
|
67
|
+
zam activate <identifier> --timeout 30
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
The identifier can be a ZAM ZID (`ZPXXXX`), UUID, or slug. Creates an order and polls until complete.
|
|
71
|
+
|
|
72
|
+
### ZAMs (Seller)
|
|
73
|
+
|
|
74
|
+
Create and manage your ZAMs on the marketplace.
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
zam zams create # Interactive ZAM creation
|
|
78
|
+
zam zams create-from-service <url> # Import from a /contract endpoint
|
|
79
|
+
zam zams list
|
|
80
|
+
zam zams get <id>
|
|
81
|
+
zam zams update <id>
|
|
82
|
+
zam zams delete <id>
|
|
83
|
+
zam zams get-secret <id> # Get/create signing secret
|
|
84
|
+
zam zams rotate-secret <id> # Rotate signing secret
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### Orders
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
zam orders list
|
|
91
|
+
zam orders get <id>
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### API Keys
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
zam api-keys list
|
|
98
|
+
zam api-keys create
|
|
99
|
+
zam api-keys update <id>
|
|
100
|
+
zam api-keys delete <id>
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### Agent Skills
|
|
104
|
+
|
|
105
|
+
Install ZAM skills for AI coding agents (Claude Code, Codex, OpenCode, Cursor):
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
npx @zeroclickai/zam-cli agents install
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Copies skill files that teach your agent how to search, create, and activate ZAMs. For Claude Code, also installs an auto-approval hook for read-only operations.
|
|
112
|
+
|
|
113
|
+
### Other
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
zam openapi # Print API endpoint summary
|
|
117
|
+
zam openapi --raw # Dump full OpenAPI JSON
|
|
118
|
+
zam config show # Show current config
|
|
119
|
+
zam config set-url # Change API base URL
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Configuration
|
|
123
|
+
|
|
124
|
+
Settings are stored in `~/.zam/config.v2.json`. Environment variables take precedence:
|
|
125
|
+
|
|
126
|
+
| Variable | Description |
|
|
127
|
+
| --- | --- |
|
|
128
|
+
| `ZAM_API_KEY` | API key |
|
|
129
|
+
| `ZAM_API_URL` | API base URL (default: `https://api.zeroclick.am`) |
|
|
130
|
+
|
|
131
|
+
## Links
|
|
132
|
+
|
|
133
|
+
- [Docs](https://docs.zeroclick.am)
|
|
134
|
+
- [Dashboard](https://www.zeroclick.am/dashboard)
|
|
135
|
+
- [API Reference](https://docs.zeroclick.am/api-reference/authentication)
|
package/bin/zam.js
ADDED