@heyamiko/amiko-cli 0.7.10 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
-# @heyamiko/amiko-cli (v0.7.10)
+# @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
 
@@ -323,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 |