@heyamiko/amiko-cli 0.7.10 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.7.10",
+  "version": "0.8.1",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {
@@ -35,5 +35,6 @@
     "@types/bun": "latest",
     "@types/node": "^22.0.0",
     "typescript": "^5.6.0"
-  }
+  },
+  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319"
 }

package/skills/SKILL.md

@@ -15,7 +15,7 @@ The `amiko` CLI is installed globally. Auth and payments are automatic via `.ami
 
 ## Critical Rules
 
-1. **Every paid command is hard-gated on `--yes` in a non-interactive shell.** The CLI will *refuse* to run `image`, `search`, `amazon search`, `service call`, `service tts`, `service stt`, `service chat`, or `credits topup` unless you pass `--yes`. The refusal is loud: it prints the cost and the command you should re-run with `--yes` appended. This means: **you must first quote the cost to the user, get their explicit approval, and only then append `--yes`**. If the user didn't approve, do not add `--yes`.
+1. **Every paid / value-moving command is hard-gated on `--yes` in a non-interactive shell.** The CLI will *refuse* to run `image`, `search`, `amazon search`, `service call`, `service tts`, `service stt`, `service chat`, `credits topup`, `swap send`, or `bridge send` unless you pass `--yes`. The refusal is loud: it prints the cost and the command you should re-run with `--yes` appended. This means: **you must first quote the cost to the user, get their explicit approval, and only then append `--yes`**. If the user didn't approve, do not add `--yes`. The same applies to destructive non-paid commands (`twin:update --public`, `docs:delete`, `friends:remove`, `avatar:update`, `voice:reset`, `composio:disconnect`).
 2. **After every paid command, report the remaining balance to the user.** The CLI prints a `Balance: N credits (~$X.XX)` line at the end of every paid command — include that figure in your reply so the user knows what they have left.
 3. **Never retry a failed command.** If a command returns an error, report it and stop. Every paid call costs tokens even on failure.
 4. **Never suggest `amiko login` or `amiko connect`.** These commands don't exist. Auth is automatic via `.amiko.json`.
@@ -151,6 +151,80 @@ amiko update                                     # update CLI to latest (on twin
 amiko --help                                     # all commands
 ```
 
+### Account & Twin
+
+```bash
+amiko accounts                                   # show resolved identity (mode, platform, user, active twin, wallets)
+amiko info                                       # fetch twin info (name, description, is_public, voice, avatar)
+amiko twin:update --name "New Name"              # rename the twin
+amiko twin:update --description "..."            # update bio
+amiko twin:update --public true --yes            # flip visibility (destructive — requires --yes in non-TTY)
+```
+
+All twin-scoped commands accept `--twin <id>` to target a non-default twin.
+
+### Documents (RAG)
+
+```bash
+amiko docs                                       # list uploaded documents
+amiko docs:upload ./notes.pdf                    # upload a local file
+amiko docs:upload https://example.com/x.pdf      # upload from URL
+cat file.pdf | amiko docs:upload - --stdin --name file.pdf  # upload from stdin
+amiko docs:delete <docId> --yes                  # delete (destructive)
+amiko docs:presign ./file.pdf                    # get a presigned S3 URL (no upload)
+```
+
+### Voice
+
+```bash
+amiko voice:design --description "warm, low, male, confident, measured"  # min 20 chars; returns preview IDs
+amiko voice:create --sample <generated_voice_id>                          # commit a designed preview
+amiko voice:clone ./me.mp3                                                # clone from an audio file (path | URL | -)
+amiko voice:reset --yes                                                   # revert to default (destructive)
+```
+
+### Avatar
+
+```bash
+amiko avatar:update --file ./portrait.png --yes  # max 5 MB image/* (destructive — changes public avatar)
+```
+
+### Friends
+
+```bash
+amiko friends                                    # list all friends
+amiko friends --type user                        # filter user-to-user
+amiko friends:add --id <userId>                  # send friend request
+amiko friends:accept <friendshipId>              # accept pending
+amiko friends:remove <friendshipId> --yes        # remove (destructive)
+```
+
+### Feed & Posts
+
+```bash
+amiko feed                                       # friends feed (default)
+amiko feed --type for_you --limit 20             # public for-you feed
+amiko feed --hashtag ai                          # filter by hashtag
+amiko post:comment --id <postId> --comment "great post"     # comment as user
+amiko post:comment --id <postId> --comment "..." --twin <id>  # comment as the twin
+```
+
+### Composio (external apps)
+
+```bash
+amiko composio:connect --app gmail               # prints OAuth URL — open in a browser
+amiko composio:disconnect --app gmail --yes      # disconnect (destructive)
+```
+
+### JSON output
+
+Every new command supports `--json` for structured output suitable for piping or parsing:
+
+```bash
+amiko friends --json | jq '.items[] | .friend.name'
+amiko info --json | jq -r '.name'
+```
+
 ## Service Costs
 
 | Service | Cost | Command |