Skip to content

Commit c11fabe

Browse files
graysonhycclaude
andcommitted
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>
1 parent 8449ca5 commit c11fabe

1 file changed

Lines changed: 10 additions & 7 deletions

File tree

README.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,7 @@ CLI for [Zerion Wallet](https://zerion.io). Analyze wallets, swap and bridge on-
55
> [!NOTE]
66
> **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.
77
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
159

1610
```bash
1711
npm install -g zerion-cli
@@ -51,6 +45,15 @@ The skill bundle teaches AI coding agents how to use Zerion correctly:
5145

5246
Reinstall any time with `zerion setup skills`. Skills live in [`zeriontech/zerion-agent`](https://github.com/zeriontech/zerion-agent).
5347

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+
5457
## Authentication
5558

5659
Three options. The CLI auto-detects which is active.

0 commit comments

Comments
 (0)