@heyamiko/amiko-cli 0.7.9 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
-# @heyamiko/amiko-cli (v0.7.9)
+# @heyamiko/amiko-cli (v0.8.0)
 
-Manage wallets, credits, swaps, and MPP marketplace services from the terminal. Works for both human users and AI agents running on OpenClaw.
+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.
 
 ## Install
 
@@ -189,6 +189,25 @@ amiko service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
 
 Audio and image endpoints upload to Supabase Storage and return permanent URLs.
 
+## Confirmation Gate for Paid Commands
+
+Every paid command (`image`, `search`, `amazon search`, `service tts`, `service stt`, `service chat`, `service call`, `credits topup`) requires explicit approval before spending:
+
+- **Human, interactive shell** — the command prints the cost and prompts `Proceed? [y/N]`. Answer `y` to run.
+- **Agent / non-interactive shell** — the command *refuses* to run without `--yes`, with a message telling the agent what to do:
+  
+  ```
+  Refusing to run without --yes (non-interactive shell detected).
+  
+  This command will cost 5 AMIKO.
+  Action: Generate image: a sunset over mountains
+  
+  Quote the cost to the user, get their explicit approval, then re-run with --yes:
+    amiko image "a sunset over mountains" --yes
+  ```
+
+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.
+
 ## Error Output
 
 When a paid command fails (payment already sent, but the upstream service returned 4xx/5xx), the CLI prints the actual upstream response body so you can see the real failure reason:
@@ -304,21 +323,81 @@ src/
 │   ├── discovery.ts      # MPP service info
 │   ├── login.ts          # Privy browser login
 │   ├── config.ts         # config management
-│   └── update.ts         # self-update
+│   ├── update.ts         # self-update
+│   ├── accounts.ts       # accounts, info (twin identity readout)
+│   ├── twin.ts           # twin:update (name/description/public)
+│   ├── docs.ts           # RAG documents (list, upload, delete, presign)
+│   ├── voice.ts          # voice:design, voice:create, voice:clone, voice:reset
+│   ├── avatar.ts         # avatar:update
+│   ├── friends.ts        # friends list, add, accept, remove
+│   ├── feed.ts           # feed, post:comment
+│   └── composio.ts       # composio:connect, composio:disconnect
 └── lib/
     ├── config.ts          # ~/.amiko/config.json
     ├── agent-config.ts    # .amiko.json reader + auth resolution
     ├── api.ts             # HTTP client (MPP + billing)
-    ├── format.ts          # terminal output helpers
+    ├── amiko-web.ts       # HTTP client for amiko-web (twin + social REST)
+    ├── twin-context.ts    # resolveTwinId (--twin | .amiko.json | config.twinId)
+    ├── file-input.ts      # path | https URL | stdin → Buffer + mime
+    ├── format.ts          # terminal output helpers + renderOutput(--json)
+    ├── confirm.ts         # requireApproval + confirmDestructive
     ├── mpp-topup.ts       # MPP SDK topup helper
     ├── across.ts          # Across Protocol bridge
     └── tempo.ts           # Tempo chain helpers
 ```
 
+## Twin & Social Commands (v0.8.0)
+
+The CLI also manages the twin's identity, documents, voice, avatar, friends, feed, and Composio connections via the amiko-web platform API.
+
+```bash
+# Identity
+amiko accounts                          # show resolved identity (mode, platform, user, twin, wallets)
+amiko info                              # fetch twin info (name, description, voice, avatar, visibility)
+amiko twin:update --name "New Name"
+amiko twin:update --description "Bio"
+amiko twin:update --public true --yes   # change public visibility (destructive)
+
+# Documents (RAG)
+amiko docs                              # list
+amiko docs:upload ./notes.pdf           # path, URL, or `- --stdin`
+amiko docs:delete <docId> --yes
+amiko docs:presign ./file.pdf           # presigned S3 URL only
+
+# Voice
+amiko voice:design --description "warm, low, male, confident, measured"
+amiko voice:create --sample <generated_voice_id>
+amiko voice:clone ./me.mp3
+amiko voice:reset --yes
+
+# Avatar
+amiko avatar:update --file ./portrait.png --yes
+
+# Friends
+amiko friends                           # list
+amiko friends:add --id <userId>
+amiko friends:accept <friendshipId>
+amiko friends:remove <friendshipId> --yes
+
+# Feed & posts
+amiko feed                              # friends feed (default)
+amiko feed --type for_you --limit 20
+amiko post:comment --id <postId> --comment "great post"
+
+# Composio
+amiko composio:connect --app gmail      # prints OAuth URL
+amiko composio:disconnect --app gmail --yes
+```
+
+Every new command accepts `--json` for structured output and `--twin <id>` where a target twin is needed.
+
+**Destructive or identity-changing commands** (`docs:delete`, `friends:remove`, `composio:disconnect`, `voice:reset`, `avatar:update`, `twin:update --public`) prompt for confirmation in a TTY and require `--yes` in non-interactive shells.
+
 ## API Endpoints
 
 | Client | Base URL | Purpose |
 |--------|----------|---------|
+| Amiko Web | `platform.heyamiko.com` | Twin identity, docs, voice, avatar, friends, feed, Composio |
 | MPP API | `mpp.amikomarkets.com` | Marketplace services, search, image, audio |
 | Billing API | `billing.heyamiko.com` | Credits, topup, wallet balances, keys |