@heyamiko/amiko-cli 0.9.0-beta.7 → 0.9.1
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 +49 -27
- package/dist/index.js +749 -147
- package/package.json +2 -1
- package/skills/SKILL.md +126 -42
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# @heyamiko/amiko-cli (v0.9.0
|
|
1
|
+
# @heyamiko/amiko-cli (v0.9.0)
|
|
2
2
|
|
|
3
3
|
Manage wallets, credits, swaps, MPP marketplace services, and your Amiko twin (identity, documents, voice, avatar, friends, feed, Composio apps) from the terminal. Works for both human users and AI agents running on OpenClaw.
|
|
4
4
|
|
|
@@ -35,18 +35,18 @@ amiko credits balance
|
|
|
35
35
|
amiko credits topup 10000 --token AMIKO --yes
|
|
36
36
|
|
|
37
37
|
# Search X/Twitter (1 AMIKO, pass --wallet)
|
|
38
|
-
amiko
|
|
38
|
+
amiko markets search "AI agents" --wallet <solana-address>
|
|
39
39
|
|
|
40
40
|
# Generate an image (5 AMIKO)
|
|
41
|
-
amiko
|
|
41
|
+
amiko markets image "a sunset over mountains" --wallet <solana-address>
|
|
42
42
|
|
|
43
43
|
# Swap tokens on Solana
|
|
44
44
|
amiko wallets swap quote 1.0 SOL USDC
|
|
45
45
|
amiko wallets swap send 1.0 SOL USDC --yes
|
|
46
46
|
|
|
47
47
|
# Call any MPP service
|
|
48
|
-
amiko
|
|
49
|
-
amiko
|
|
48
|
+
amiko markets service list
|
|
49
|
+
amiko markets service call POST /v1/sfx '{"text":"thunder","duration_seconds":5}'
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
## Credits
|
|
@@ -82,7 +82,7 @@ amiko credits topup 10000 --token AMIKO # 10,000 credits in AMIKO
|
|
|
82
82
|
```bash
|
|
83
83
|
amiko credits topup 10000 --token USDC --chain base # USDC on Base
|
|
84
84
|
amiko credits topup 5000 --method mpp # MPP 402 payment
|
|
85
|
-
amiko credits topup 10000 --wallet Gu2b...QVya # specific wallet
|
|
85
|
+
amiko credits topup 10000 --wallet Gu2b...QVya # specific wallet (else defaults to your Solana wallet)
|
|
86
86
|
```
|
|
87
87
|
|
|
88
88
|
**Supported tokens:** AMIKO, SOL, USDC, USDT
|
|
@@ -93,9 +93,9 @@ amiko credits topup 10000 --wallet Gu2b...QVya # specific wallet
|
|
|
93
93
|
## Search
|
|
94
94
|
|
|
95
95
|
```bash
|
|
96
|
-
amiko
|
|
97
|
-
amiko
|
|
98
|
-
amiko
|
|
96
|
+
amiko markets search "AI agents" # search X/Twitter (1 AMIKO)
|
|
97
|
+
amiko markets search "bitcoin" --token USDC # pay with USDC instead
|
|
98
|
+
amiko markets search "news" --raw # raw JSON output
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
Pays 1 AMIKO per search via Crossmint wallet transfer. Tries Solana wallet first, falls back to EVM.
|
|
@@ -103,12 +103,12 @@ Pays 1 AMIKO per search via Crossmint wallet transfer. Tries Solana wallet first
|
|
|
103
103
|
## Image Generation
|
|
104
104
|
|
|
105
105
|
```bash
|
|
106
|
-
amiko
|
|
107
|
-
amiko
|
|
108
|
-
amiko
|
|
109
|
-
amiko
|
|
110
|
-
amiko
|
|
111
|
-
amiko
|
|
106
|
+
amiko markets image "a sunset over mountains" # gpt-image-1 (default)
|
|
107
|
+
amiko markets image "logo" --background transparent # transparent background
|
|
108
|
+
amiko markets image "cat" --model dall-e-3 # DALL-E 3
|
|
109
|
+
amiko markets image "portrait" --size 1024x1792 --quality high # portrait, high quality
|
|
110
|
+
amiko markets image "icon" --format webp # webp output
|
|
111
|
+
amiko markets image "banner" --raw # raw JSON
|
|
112
112
|
```
|
|
113
113
|
|
|
114
114
|
Costs 5 AMIKO per image. Returns a Supabase Storage URL.
|
|
@@ -118,8 +118,8 @@ Image generation typically takes 20–60s. In non-TTY environments (agents, pipe
|
|
|
118
118
|
## Amazon
|
|
119
119
|
|
|
120
120
|
```bash
|
|
121
|
-
amiko
|
|
122
|
-
amiko
|
|
121
|
+
amiko markets amazon search "usb c cable" # product search (1 AMIKO)
|
|
122
|
+
amiko markets amazon quote B01GGKYKQM # price quote (free)
|
|
123
123
|
```
|
|
124
124
|
|
|
125
125
|
## Swap
|
|
@@ -158,24 +158,24 @@ Default route: Solana → Tempo. Use `--from` and `--to` flags for other chains.
|
|
|
158
158
|
Call any endpoint on the Amiko marketplace with automatic AMIKO payment:
|
|
159
159
|
|
|
160
160
|
```bash
|
|
161
|
-
amiko
|
|
162
|
-
amiko
|
|
161
|
+
amiko markets service list # all services + prices
|
|
162
|
+
amiko markets service call <METHOD> <path> [body]
|
|
163
163
|
```
|
|
164
164
|
|
|
165
165
|
**Examples:**
|
|
166
166
|
|
|
167
167
|
```bash
|
|
168
168
|
# Sound effects ($0.05) — returns { url, format, service }
|
|
169
|
-
amiko
|
|
169
|
+
amiko markets service call POST /v1/sfx '{"text":"Thunder with heavy rain","duration_seconds":5}'
|
|
170
170
|
|
|
171
171
|
# Music generation ($0.10) — returns { url, format, service }
|
|
172
|
-
amiko
|
|
172
|
+
amiko markets service call POST /v1/music '{"prompt":"Lo-fi chill beat","music_length_ms":30000}'
|
|
173
173
|
|
|
174
174
|
# Text-to-speech (1 AMIKO) — returns { url, format, service }
|
|
175
|
-
amiko
|
|
175
|
+
amiko markets service tts 21m00Tcm4TlvDq8ikWAM "Hello world"
|
|
176
176
|
|
|
177
177
|
# Composition plan ($0.02)
|
|
178
|
-
amiko
|
|
178
|
+
amiko markets service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
|
|
179
179
|
```
|
|
180
180
|
|
|
181
181
|
Audio and image endpoints upload to Supabase Storage and return permanent URLs.
|
|
@@ -194,7 +194,7 @@ Every paid / value-moving command (`image`, `search`, `amazon search`, `service
|
|
|
194
194
|
Action: Generate image: a sunset over mountains
|
|
195
195
|
|
|
196
196
|
Quote the cost to the user, get their explicit approval, then re-run with --yes:
|
|
197
|
-
amiko
|
|
197
|
+
amiko markets image "a sunset over mountains" --yes
|
|
198
198
|
```
|
|
199
199
|
|
|
200
200
|
This makes cost confirmation effectively mandatory regardless of which model drives the agent — weak models can no longer silently burn tokens by ignoring the skill docs. The same refusal fires for `swap send` (Solana gas + 10 bps platform fee) and `bridge send` (Across fee + gas), so an agent cannot move tokens without a round-trip through user approval.
|
|
@@ -215,7 +215,7 @@ JSON `error` / `message` / `detail` fields are extracted when present; raw body
|
|
|
215
215
|
## Other Commands
|
|
216
216
|
|
|
217
217
|
```bash
|
|
218
|
-
amiko
|
|
218
|
+
amiko markets discover # MPP service info + pricing
|
|
219
219
|
amiko config show # view config
|
|
220
220
|
amiko config set <key> <value> # set config value
|
|
221
221
|
amiko update # update CLI to latest (full twin refresh — no restart needed)
|
|
@@ -252,7 +252,7 @@ Agents auto-authenticate via `.amiko.json` — no manual connect needed. The pla
|
|
|
252
252
|
```bash
|
|
253
253
|
# Agent environment — just works
|
|
254
254
|
amiko credits balance
|
|
255
|
-
amiko
|
|
255
|
+
amiko markets search "trending topics"
|
|
256
256
|
amiko credits topup 10000 --token AMIKO --yes
|
|
257
257
|
```
|
|
258
258
|
|
|
@@ -298,7 +298,8 @@ src/
|
|
|
298
298
|
│ ├── docs.ts # RAG documents (list, upload, delete, presign)
|
|
299
299
|
│ ├── voice.ts # voice design, voice create, voice clone, voice reset
|
|
300
300
|
│ ├── avatar.ts # avatar update
|
|
301
|
-
│ ├── friends.ts # friends list, add, accept, remove
|
|
301
|
+
│ ├── friends.ts # friends list, requests, add, accept, remove, matches, reports
|
|
302
|
+
│ ├── users.ts # users search, profile
|
|
302
303
|
│ ├── feed.ts # feed, post create, post comment
|
|
303
304
|
│ └── composio.ts # composio connect, composio disconnect
|
|
304
305
|
└── lib/
|
|
@@ -344,9 +345,17 @@ amiko avatar update --file ./portrait.png --yes
|
|
|
344
345
|
|
|
345
346
|
# Friends
|
|
346
347
|
amiko friends list # list
|
|
348
|
+
amiko friends requests # pending requests (incoming + outgoing)
|
|
347
349
|
amiko friends add --id <userId>
|
|
348
350
|
amiko friends accept <friendshipId>
|
|
349
351
|
amiko friends remove <friendshipId> --yes
|
|
352
|
+
amiko friends matches # personality match candidates
|
|
353
|
+
amiko friends reports list # friend matching reports
|
|
354
|
+
amiko friends reports view <reportId>
|
|
355
|
+
|
|
356
|
+
# Users
|
|
357
|
+
amiko users search <query> # find users by name/handle
|
|
358
|
+
amiko users profile <handle> # public profile
|
|
350
359
|
|
|
351
360
|
# Feed & posts
|
|
352
361
|
amiko feed # friends feed (default)
|
|
@@ -382,6 +391,19 @@ npm publish
|
|
|
382
391
|
|
|
383
392
|
## Changelog
|
|
384
393
|
|
|
394
|
+
### 0.9.0-beta.10
|
|
395
|
+
|
|
396
|
+
- **Rename**: top-level `market` command group is now `markets` (e.g. `amiko markets search`, `amiko markets image`).
|
|
397
|
+
- `wallets create --chain` now accepts only `solana | base` (devnet/sepolia variants removed from the CLI surface).
|
|
398
|
+
- `SKILL.md` rewritten with a top-level command overview, `--wallet` default explainer, and a "run from your workspace folder" note.
|
|
399
|
+
|
|
400
|
+
### 0.9.0-beta.9
|
|
401
|
+
|
|
402
|
+
- `amiko wallets create --chain solana|base` — create a new wallet for the twin (Crossmint custodian by default).
|
|
403
|
+
- `--wallet` is now optional on all paid commands (`markets search`, `markets image`, `markets amazon search`, `markets service *`, `wallets swap send`). If omitted, the CLI auto-uses the twin's active Solana wallet. Pass `--wallet <address>` to override.
|
|
404
|
+
- `wallets bridge quote/send` — `--depositor` now defaults to your wallet on the origin chain (Solana for `--from solana`, Base for `--from base`).
|
|
405
|
+
- Help text and `SKILL.md` updated to document the new default.
|
|
406
|
+
|
|
385
407
|
### 0.9.0-beta.7
|
|
386
408
|
|
|
387
409
|
- **Breaking**: colon-style commands are now subcommand groups. `twin:update` → `twin update`, `docs:upload` → `docs upload`, `voice:design` → `voice design`, `avatar:update` → `avatar update`, `friends:add` → `friends add`, `post:create` → `post create`, `composio:connect` → `composio connect`, etc. No aliases — scripts and skills that used the old names must be updated. Bare `docs` and `friends` now require `list` (e.g. `amiko docs list`).
|