@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 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
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ import "../dist/index.js";