You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: reorder Installation before agent-design section and rewrite the duality framing
- Rename `## Install` to `## Installation` and move it ahead of the agent-design section so practical setup comes first
- Replace generic "Built for agents" block with "Manual setup, agent execution" — frames the CLI as two distinct surfaces (manual wallet ops with passphrase prompts and QR sync vs JSON-first analysis/trading meant for agents) so it doesn't read as Alpaca's framing rerun
- Tie agent-token + policy story to the duality: stage by hand once, then hand a scoped token to automation
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+10-7Lines changed: 10 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,13 +5,7 @@ CLI for [Zerion Wallet](https://zerion.io). Analyze wallets, swap and bridge on-
5
5
> [!NOTE]
6
6
> **Alpha Preview** — This CLI is under active development. Commands, flags, and output formats may change or be removed without notice between releases. Do not depend on current behavior in production workflows.
7
7
8
-
### Built for agents
9
-
10
-
This CLI is designed primarily for AI agents and automation pipelines, not as a general-purpose interactive terminal tool. JSON-first output by default, no confirmation prompts on data commands, structured error codes on stderr. Every command executes immediately and returns parsable output.
11
-
12
-
**This means destructive commands are truly destructive.** Once an agent token is configured, `zerion swap` and `zerion bridge` execute trades immediately — no "are you sure?" dialog. Treat agent tokens like API keys with spending power and use [agent policies](#agent-policies) to scope what they can do.
13
-
14
-
## Install
8
+
## Installation
15
9
16
10
```bash
17
11
npm install -g zerion-cli
@@ -51,6 +45,15 @@ The skill bundle teaches AI coding agents how to use Zerion correctly:
51
45
52
46
Reinstall any time with `zerion setup skills`. Skills live in [`zeriontech/zerion-agent`](https://github.com/zeriontech/zerion-agent).
53
47
48
+
## Manual setup, agent execution
49
+
50
+
Zerion CLI splits into two surfaces, by design.
51
+
52
+
-**Wallet management is manual.**`wallet create`, `import`, `backup`, and `delete` all prompt for a passphrase. `wallet sync` emits a QR code you scan with the Zerion app. These commands assume a human at the keyboard — no key material moves without an explicit gesture.
53
+
-**Analysis and trading are for agents.**`analyze`, `portfolio`, `swap`, `bridge`, and `send` emit JSON to stdout, structured errors to stderr, and skip confirmation dialogs. Once an agent token is configured, trades fire immediately.
54
+
55
+
The split is the point. You stage a wallet by hand once — create or import a key, set a passphrase, mint an agent token, attach a policy — then hand the agent token to an automation that can only do what the policy allows. Treat agent tokens like API keys with spending power; use [agent policies](#agent-policies) to scope them down to specific chains, addresses, or expiry windows.
56
+
54
57
## Authentication
55
58
56
59
Three options. The CLI auto-detects which is active.
0 commit comments