@zeroxyz/cli 0.0.47 → 1.1.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 CHANGED
@@ -4,15 +4,39 @@ The `zero` CLI lets AI agents discover, call, and review capabilities indexed by
4
4
 
5
5
  ## Install
6
6
 
7
+ The recommended way to install and initialize Zero skill and hooks is via Agent Plugins — see the Zero agent plugin at [github.com/officialzeroxyz/zero-plugins](https://github.com/officialzeroxyz/zero-plugins). The npm package installs just the CLI:
8
+
7
9
  ```bash
8
10
  npm install -g @zeroxyz/cli
9
11
  ```
10
12
 
13
+ ## Breaking changes
14
+
15
+ ### 1.0.0
16
+
17
+ - **`zero init` no longer does anything.** It used to generate a local wallet and copy skills/hooks into your agent tools; it now just prints a pointer to the [Zero agent plugin](https://github.com/officialzeroxyz/zero-plugins). The bundled skill is no longer shipped in this package — fetch it from [zero.xyz/SKILL.md](https://zero.xyz/SKILL.md) for a manual install. `zero uninstall` still removes anything a pre-1.0 `zero init` left behind.
18
+ - **`zero welcome` was removed.** The welcome bonus is claimed by signing in (`zero auth login`).
19
+ - **The legacy `privateKey` field in `~/.zero/config.json` is no longer an identity and never pays.** Wallets created by a pre-1.0 `zero init` stop signing requests and payments. Pick one of:
20
+ - **Recommended:** sign in and sweep the old wallet's funds into your managed Zero wallet:
21
+
22
+ ```bash
23
+ zero auth login
24
+ zero wallet migrate
25
+ ```
26
+
27
+ - **Keep self-custody:** promote the old key to an explicit self-custody wallet (stored as `byoPrivateKey`, which outranks managed signing):
28
+
29
+ ```bash
30
+ zero wallet set "$(jq -r '.privateKey' ~/.zero/config.json)"
31
+ ```
32
+
33
+ `wallet set` backs the old config up to `~/.zero/config.backup.json` and removes the legacy `privateKey` field, so the two never coexist.
34
+
11
35
  ## Quick Start
12
36
 
13
37
  ```bash
14
- # Generate a wallet
15
- zero init
38
+ # Sign in (provisions your managed Zero wallet)
39
+ zero auth login
16
40
 
17
41
  # Search for capabilities
18
42
  zero search "translate text to French"
@@ -29,15 +53,19 @@ zero review <runId> --success --accuracy 5 --value 4 --reliability 5
29
53
 
30
54
  ## Commands
31
55
 
32
- ### `zero init`
56
+ ### `zero auth`
33
57
 
34
- Generate a wallet, if needed.
58
+ Sign in and out of Zero. Signing in provisions a managed Zero wallet that signs your payments.
35
59
 
36
60
  ```bash
37
- zero init
38
- zero init --force # overwrite existing config
61
+ zero auth login # device-code sign-in (opens a browser)
62
+ zero auth login --start --json # agent-driven flows: print URL + code, exit
63
+ zero auth login --finish <deviceCode> # complete a --start flow
64
+ zero auth logout
39
65
  ```
40
66
 
67
+ Prefer your own wallet? `zero wallet set <0x-private-key>` stores a self-custody key that outranks managed signing.
68
+
41
69
  ### `zero search <query>`
42
70
 
43
71
  Search for capabilities by free-text query.