@heyamiko/amiko-cli 0.7.0 → 0.7.2

package/README.md

@@ -1,13 +1,11 @@
-# amiko-cli (v0.6.6)
+# @heyamiko/amiko-cli (v0.7.0)
 
-Manage agents, wallets, credits, and the MPP marketplace from your terminal. Works for both human users and AI agents running on OpenClaw.
+Manage wallets, credits, swaps, and MPP marketplace services from the terminal. Works for both human users and AI agents running on OpenClaw.
 
 ## Install
 
 ```bash
 npm install -g @heyamiko/amiko-cli
-# or
-bun install -g @heyamiko/amiko-cli
 ```
 
 Update to latest:
@@ -30,13 +28,19 @@ amiko credits balance
 # Top up credits from your agent's wallet
 amiko credits topup 10000 --token AMIKO --yes
 
-# Swap tokens
-amiko swap quote SOL USDC 1.0
-amiko swap send SOL USDC 1.0 --yes
+# Search X/Twitter (1 AMIKO)
+amiko search "AI agents"
 
-# Browse and call marketplace agents
-amiko browse
-amiko call titan-research "Summarize the latest AI news"
+# Generate an image (5 AMIKO)
+amiko image "a sunset over mountains"
+
+# Swap tokens on Solana
+amiko swap quote 1.0 SOL USDC
+amiko swap send 1.0 SOL USDC --yes
+
+# Call any MPP service
+amiko service list
+amiko service call POST /v1/sfx '{"text":"thunder","duration_seconds":5}'
 ```
 
 ## Connect
@@ -49,11 +53,10 @@ amiko connect amk_<key>           # API key (shown once at creation)
 amiko connect                     # browser sign-in flow
 ```
 
-The connect code is the simplest -- generate one from your Amiko settings page, paste it to the agent or terminal.
+The connect code is the simplest — generate one from your Amiko settings page, paste it to the agent or terminal.
 
 ```bash
 amiko whoami                      # show current auth status
-amiko logout                      # clear stored credentials
 ```
 
 ## Credits
@@ -74,135 +77,130 @@ amiko credits topup 10000 --wallet Gu2b...QVya        # specific wallet address
 amiko credits topup 10000 --yes                       # skip confirmation
 ```
 
-**How it works:**
-1. CLI fetches live token price from Jupiter
-2. Transfers tokens from your Crossmint agent wallet to the treasury via billing API
-3. Verifies the on-chain transfer and credits your account
-4. All calls go through `billing.heyamiko.com` -- no other dependencies
-
-**Supported tokens:** AMIKO, SOL, USDC, USDT, ETH
+**Supported tokens:** AMIKO, SOL, USDC, USDT
 **Supported chains:** Solana, Base, Ethereum, Tempo
 
-## Swap
+## Search
 
 ```bash
-amiko swap quote <from> <to> <amount>    # get Jupiter quote
-amiko swap send <from> <to> <amount>     # execute swap
-amiko swap tokens                         # list supported tokens
+amiko search "AI agents"                 # search X/Twitter (1 AMIKO)
+amiko search "bitcoin" --token USDC      # pay with USDC instead
+amiko search "news" --raw                # raw JSON output
 ```
 
-Swaps execute via Jupiter on Solana using the agent's Crossmint wallet.
+Pays 1 AMIKO per search via Crossmint wallet transfer. Tries Solana wallet first, falls back to EVM.
 
-## Wallet
+## Image Generation
 
 ```bash
-amiko wallet create               # create MPP wallet on Tempo
-amiko wallet balance [address]    # check USDC.e balance
-amiko wallet balance --watch      # poll every 5s
-amiko wallet send <to> <amount>   # send tokens via Crossmint wallet
-amiko wallet topup <amount>       # Stripe checkout ($1-$100)
-amiko wallet deposit [address]    # USDC.e deposit instructions
-amiko wallet login                # Tempo wallet login
-amiko wallet whoami               # Tempo wallet identity
-amiko wallet fund                 # fund via Tempo dashboard
+amiko image "a sunset over mountains"                    # gpt-image-1 (default)
+amiko image "logo" --background transparent              # transparent background
+amiko image "cat" --model dall-e-3                       # DALL-E 3
+amiko image "portrait" --size 1024x1792 --quality high   # portrait, high quality
+amiko image "icon" --format webp                         # webp output
+amiko image "banner" --raw                               # raw JSON
 ```
 
-## Marketplace
+Costs 5 AMIKO per image. Returns a Supabase Storage URL.
+
+## Amazon
 
 ```bash
-amiko browse                      # browse agents
-amiko browse -c research -l 10   # filter by category
-amiko info <agent>                # agent details + pricing
-amiko popular                     # trending agents
-amiko activity                    # recent payments
-amiko leaderboard                 # top creators
+amiko amazon search "usb c cable"        # product search (1 AMIKO)
+amiko amazon quote B01GGKYKQM            # price quote (free)
 ```
 
-## Calling Agents
+## Swap
 
 ```bash
-amiko call <agent> "message"      # single message
-amiko call <agent> -i             # interactive REPL
-echo "input" | amiko call <agent> # pipe input
-amiko call <agent> "msg" --task   # task endpoint
-amiko call <agent> "msg" --dry-run # preview cost
+amiko swap quote <amount> <from> <to>    # get Jupiter quote
+amiko swap send <amount> <from> <to>     # execute swap via Crossmint
+amiko swap tokens                        # list supported tokens
 ```
 
-## Creator Dashboard
+**Examples:**
 
 ```bash
-amiko creator summary             # earnings + listings
-amiko creator listings            # your agent listings
-amiko creator publish <id>        # publish a draft
-amiko creator payout              # request payout
+amiko swap quote 1.0 SOL USDC
+amiko swap send 0.5 USDC AMIKO --yes
+amiko swap send 100 AMIKO SOL --slippage 100
 ```
 
+Swaps execute via Jupiter on Solana. Supports SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL, mSOL, or any mint address.
+
 ## Bridge
 
 ```bash
-amiko bridge quote <amount>       # cross-chain bridge quote via Across Protocol
-amiko bridge send <amount>        # execute bridge transfer
-amiko bridge status <txHash>      # check bridge status
-amiko bridge routes               # available bridge routes
-amiko bridge limits               # min/max limits per route
+amiko bridge quote <amount>              # cross-chain USDC quote via Across Protocol
+amiko bridge send <amount>               # execute bridge transfer
+amiko bridge status <txHash>             # check bridge status
+amiko bridge routes                      # available bridge routes
+amiko bridge limits                      # min/max limits per route
 ```
 
-## Audio & Voice
+Default route: Solana → Tempo. Use `--from` and `--to` flags for other chains.
+
+## MPP Services
 
-All audio endpoints return binary audio streams. Use `amiko service call` for direct access:
+Call any endpoint on the Amiko marketplace with automatic AMIKO payment:
 
 ```bash
-# Sound effects ($0.05)
+amiko service list                       # all services + prices
+amiko service call <METHOD> <path> [body]
+```
+
+**Examples:**
+
+```bash
+# Sound effects ($0.05) — returns { url, format, service }
 amiko service call POST /v1/sfx '{"text":"Thunder with heavy rain","duration_seconds":5}'
 
-# Music generation ($0.10)
+# Music generation ($0.10) — returns { url, format, service }
 amiko service call POST /v1/music '{"prompt":"Lo-fi chill beat","music_length_ms":30000}'
 
-# Composition plan ($0.02) — get JSON plan before generating
-amiko service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
-
-# Text-to-speech ($0.50/1K chars)
-amiko service call POST /v1/tts/21m00Tcm4TlvDq8ikWAM '{"text":"Hello world"}'
+# Text-to-speech (1 AMIKO) — returns { url, format, service }
+amiko service tts 21m00Tcm4TlvDq8ikWAM "Hello world"
 
-# List all available services + prices
-amiko service list
+# Composition plan ($0.02)
+amiko service call POST /v1/music/plan '{"prompt":"Epic orchestral piece"}'
 ```
 
-## Other Commands
+Audio and image endpoints upload to Supabase Storage and return permanent URLs.
+
+## Wallet
 
 ```bash
-amiko reputation [address]        # TARS score
-amiko discover                    # MPP service info
-amiko ping                        # health check
-amiko config show                 # view config
-amiko config set <key> <value>    # set config value
-amiko update                      # update CLI to latest
+amiko wallet balance [address]           # check USDC.e balance on Tempo
+amiko wallet balance --watch             # poll every 5s (stops after 10 errors)
+amiko wallet send <to> <amount>          # send tokens from agent wallet
+amiko wallet topup <amount>              # Stripe checkout ($1-$100)
+amiko wallet deposit [address]           # USDC.e deposit instructions
+amiko wallet login                       # Tempo wallet login (browser)
+amiko wallet whoami                      # Tempo wallet identity
+amiko wallet fund                        # fund via Tempo dashboard
 ```
 
-## X Search
+## Other Commands
 
 ```bash
-amiko search "AI agents"                 # search X (pays 1 AMIKO from Solana wallet)
-amiko search "bitcoin" --token USDC      # pay with USDC instead
-amiko search "news" --raw                # raw JSON output
+amiko discovery                          # MPP service info + pricing
+amiko config show                        # view config
+amiko config set <key> <value>           # set config value
+amiko update                             # update CLI to latest
+amiko --help                             # all commands
 ```
 
-Pays via Crossmint server-signed transfer from the agent's wallet. Tries Solana wallet first, falls back to EVM (Base/Tempo).
+## Agent Integration (OpenClaw)
 
-## Image Generation
+### Install as OpenClaw plugin
 
 ```bash
-amiko image "a sunset over mountains"                    # gpt-image-1 (default, base64)
-amiko image "logo" --background transparent              # transparent background
-amiko image "cat" --model dall-e-3                       # DALL-E 3 (returns URL)
-amiko image "portrait" --size 1024x1792 --quality high   # portrait, high quality
-amiko image "icon" --format webp                         # webp output
-amiko image "banner" --raw                               # raw JSON (for piping)
+openclaw plugins install @heyamiko/amiko-cli
 ```
 
-Costs 5 AMIKO per image. Default model is `gpt-image-1` which returns base64 data (permanent, no expiring URLs).
+This registers the CLI's skill file so the agent discovers all commands through the normal skill system. Updates to the CLI (`npm update -g @heyamiko/amiko-cli`) also update the skill docs.
 
-## Agent Integration (OpenClaw)
+### Authentication
 
 Agents auto-authenticate via `.amiko.json` — no manual connect needed. The platform writes this file during twin init with wallets, billing config, and twin token.
 
@@ -219,13 +217,19 @@ The CLI checks for `.amiko.json` in order:
 3. `/data/.openclaw/workspace/.amiko.json`
 4. Walking up from `cwd`
 
-The `.amiko.json` provides: `AMIKO_TWIN_TOKEN` (auth), `agentWallets` (Solana + Base addresses), `billingBase`, and optionally `platformKey`.
+Supported keys (both camelCase and SCREAMING_SNAKE_CASE):
+- `amikoTwinToken` / `AMIKO_TWIN_TOKEN` — auth token
+- `amikoTwinId` / `AMIKO_TWIN_ID` — twin identifier
+- `amikoPlatformUrl` / `AMIKO_PLATFORM_URL` — platform base URL
+- `agentWallets` — array of `{ chain, address }`
+- `billingBase` — billing API URL
+- `platformKey` — API key override
 
-**Important:** If `~/.amiko/config.json` exists with a stale `apiKey`, it takes priority over `.amiko.json` twin token. Remove stale keys or let the platform manage auth.
+**Stale config pitfall:** If `~/.amiko/config.json` exists with an old `apiKey`, it takes priority over `.amiko.json` twin token. Remove stale keys or let the platform manage auth.
 
 ## Configuration
 
-Config: `~/.amiko/config.json`
+Config file: `~/.amiko/config.json`
 
 | Key | Default |
 |-----|---------|
@@ -242,29 +246,40 @@ src/
 ├── commands/
 │   ├── connect.ts        # connect (code, API key, browser)
 │   ├── credits.ts        # credits balance + topup
-│   ├── swap.ts           # Jupiter token swaps
+│   ├── search.ts         # X/Twitter search (1 AMIKO via MPP)
+│   ├── image.ts          # image generation (gpt-image-1, 5 AMIKO)
+│   ├── amazon.ts         # Amazon search + quote
+│   ├── swap.ts           # Jupiter token swaps (Solana)
 │   ├── bridge.ts         # Across Protocol cross-chain bridge
-│   ├── browse.ts         # marketplace browsing
-│   ├── call.ts           # call agents
-│   ├── wallet.ts         # wallet management (Crossmint + Tempo)
-│   ├── creator.ts        # creator dashboard
+│   ├── wallet.ts         # wallet management (Tempo + Crossmint)
+│   ├── services.ts       # generic MPP service calling
+│   ├── discovery.ts      # MPP service info
 │   ├── login.ts          # Privy browser login
-│   ├── update.ts         # self-update
 │   ├── config.ts         # config management
-│   ├── discovery.ts      # MPP service info
-│   ├── marketplace.ts    # activity, leaderboard, popular
-│   └── reputation.ts     # TARS score
+│   └── update.ts         # self-update
 └── lib/
     ├── config.ts          # ~/.amiko/config.json
-    ├── agent-config.ts    # .amiko.json reader + auto-auth
-    ├── api.ts             # HTTP client for MPP + billing
-    ├── format.ts          # table, usd, truncAddr helpers
+    ├── agent-config.ts    # .amiko.json reader + auth resolution
+    ├── api.ts             # HTTP client (MPP + billing)
+    ├── format.ts          # terminal output helpers
     ├── mpp-topup.ts       # MPP SDK topup helper
     ├── across.ts          # Across Protocol bridge
-    └── tempo.ts           # Tempo wallet CLI wrapper
+    └── tempo.ts           # Tempo chain helpers
 ```
 
-Built with [Commander](https://github.com/tj/commander.js), [chalk](https://github.com/chalk/chalk), [ora](https://github.com/sindresorhus/ora), [@solana/mpp](https://github.com/solana-foundation/mpp-sdk), and [@crossmint/wallets-sdk](https://www.crossmint.com). Bundled with [Bun](https://bun.sh).
+## API Endpoints
+
+| Client | Base URL | Purpose |
+|--------|----------|---------|
+| MPP API | `mpp.amikomarkets.com` | Marketplace services, search, image, audio |
+| Billing API | `billing.heyamiko.com` | Credits, topup, wallet balances, keys |
+
+## Build
+
+```bash
+bun build src/index.ts --outdir dist --target node --format esm
+npm publish
+```
 
 ## License
 

package/dist/index.js

@@ -24968,7 +24968,7 @@ var require_fallback = __commonJS((exports, module) => {
 
 // node_modules/bufferutil/index.js
 var require_bufferutil = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/Amiko-Layer/Amiko-Layer/amiko-cli/node_modules/bufferutil";
+  var __dirname = "/Users/mars/mars-dev/AMIKO/Amiko-Layer/amiko-cli/node_modules/bufferutil";
   try {
     module.exports = require_node_gyp_build2()(__dirname);
   } catch (e3) {
@@ -25384,7 +25384,7 @@ var require_fallback2 = __commonJS((exports, module) => {
 
 // node_modules/utf-8-validate/index.js
 var require_utf_8_validate = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/Amiko-Layer/Amiko-Layer/amiko-cli/node_modules/utf-8-validate";
+  var __dirname = "/Users/mars/mars-dev/AMIKO/Amiko-Layer/amiko-cli/node_modules/utf-8-validate";
   try {
     module.exports = require_node_gyp_build2()(__dirname);
   } catch (e3) {
@@ -73113,7 +73113,7 @@ function registerWalletCommand(program2) {
       process.exit(1);
     }
     const fetchBalance = async () => {
-      const data = await get(`/v1/wallet/${addr}/balance`);
+      const data = await get(`/v1/wallet/balance/${addr}`);
       return parseFloat(data.balance || data.usdce || "0").toFixed(4);
     };
     if (opts.watch) {
@@ -73123,9 +73123,12 @@ function registerWalletCommand(program2) {
       console.log(label("Address", truncAddr(addr)));
       console.log(dim(`Polling every ${intervalMs / 1000}s — Ctrl+C to stop
 `));
+      let consecutiveErrors = 0;
+      const MAX_ERRORS = 10;
       const poll2 = async () => {
         try {
           const bal = await fetchBalance();
+          consecutiveErrors = 0;
           const ts = new Date().toLocaleTimeString();
           const changed = last !== "" && bal !== last;
           const prefix = changed ? source_default.yellow("↕") : source_default.dim("·");
@@ -73133,11 +73136,21 @@ function registerWalletCommand(program2) {
           process.stdout.write(`\r${prefix} ${dim(ts)}  ${value}    `);
           last = bal;
         } catch {
-          process.stdout.write(`\r${source_default.red("!")} ${dim(new Date().toLocaleTimeString())}  ${dim("fetch error")}    `);
+          consecutiveErrors++;
+          process.stdout.write(`\r${source_default.red("!")} ${dim(new Date().toLocaleTimeString())}  ${dim(`fetch error (${consecutiveErrors}/${MAX_ERRORS})`)}    `);
+          if (consecutiveErrors >= MAX_ERRORS) {
+            console.log(`
+${error("Too many consecutive errors, stopping watch.")}`);
+            process.exit(1);
+          }
         }
       };
       await poll2();
-      setInterval(() => void poll2(), intervalMs);
+      const timer = setInterval(() => void poll2(), intervalMs);
+      process.on("SIGINT", () => {
+        clearInterval(timer);
+        process.exit(0);
+      });
       return;
     }
     const spinner = ora("Fetching balance...").start();
@@ -74561,7 +74574,7 @@ function registerCreditsCommand(program2) {
       process.exit(1);
     }
   });
-  credits.command("topup <amount>").description("Top up credits from an agent wallet").option("--token <TOKEN>", "Token to use for top-up").option("--chain <CHAIN>", "Chain to use for top-up").option("--wallet <ADDR>", "Wallet address to use").option("--method <METHOD>", "Payment method: auto, crossmint, mpp", "auto").option("--yes", "Skip confirmation prompt").action(async (amountStr, options) => {
+  credits.command("topup <amount>").description("Top up credits by spending tokens from your agent wallet").option("--token <TOKEN>", "Token to use for top-up").option("--chain <CHAIN>", "Chain to use for top-up").option("--wallet <ADDR>", "Wallet address to use").option("--method <METHOD>", "Payment method: auto, crossmint, mpp", "auto").option("--yes", "Skip confirmation prompt").action(async (amountStr, options) => {
     const creditsAmount = parseInt(amountStr.replace(/,/g, ""), 10);
     if (isNaN(creditsAmount) || creditsAmount <= 0) {
       console.error(error(`Invalid amount: ${amountStr}`));
@@ -74592,11 +74605,6 @@ function registerCreditsCommand(program2) {
         "Content-Type": "application/json"
       };
       spinner.stop();
-      if (!options.yes) {
-        console.log(warn(`About to top up ${creditsAmount} credits.`));
-        console.log(dim("Use --yes to skip this confirmation."));
-        console.log("");
-      }
       if (options.method === "mpp" && auth.userId && auth.connectedKeyId) {
         const spinner2 = ora("Topping up credits via MPP...").start();
         const mppResult = await mppCreditsTopup({
@@ -74626,9 +74634,11 @@ function registerCreditsCommand(program2) {
       }
       const usdAmount = creditsAmount / 1e4;
       let tokenAmount;
+      let pricePerToken = null;
       const stablecoins = ["usdc", "usdt", "usdc.e", "usdt0"];
       if (stablecoins.includes(token.toLowerCase())) {
         tokenAmount = usdAmount;
+        pricePerToken = 1;
       } else {
         const spinner2 = ora(`Fetching ${token} price...`).start();
         try {
@@ -74652,18 +74662,26 @@ function registerCreditsCommand(program2) {
             process.exit(1);
           }
           const jupData = await jupRes.json();
-          const pricePerToken = parseFloat(jupData.outAmount) / 1e6;
+          pricePerToken = parseFloat(jupData.outAmount) / 1e6;
           tokenAmount = usdAmount / pricePerToken;
           spinner2.stop();
-          console.log(label("Price", `1 ${token} = $${pricePerToken.toFixed(4)}`));
-          console.log(label("Cost", `${tokenAmount.toFixed(6)} ${token} (~$${usdAmount.toFixed(2)})`));
-          console.log("");
         } catch {
           spinner2.stop();
           console.error(error("Failed to fetch token price"));
           process.exit(1);
         }
       }
+      const shortWallet = walletAddr.length > 12 ? `${walletAddr.slice(0, 6)}...${walletAddr.slice(-4)}` : walletAddr;
+      console.log(heading("Top-up Summary"));
+      console.log("");
+      console.log(label("Credits", creditsAmount.toLocaleString()));
+      console.log(label("Cost", `${tokenAmount.toFixed(6)} ${token} (~$${usdAmount.toFixed(2)})`));
+      if (pricePerToken && pricePerToken !== 1) {
+        console.log(label("Price", `1 ${token} = $${pricePerToken.toFixed(4)}`));
+      }
+      console.log(label("From", `wallet ${shortWallet} (${walletChain})`));
+      console.log(dim("Tokens will be transferred from your agent wallet to the treasury."));
+      console.log("");
       if (["base", "ethereum", "tempo"].includes(walletChain)) {
         console.error(error("EVM topup not supported yet. Use a Solana wallet with --token AMIKO, USDC, USDT, or SOL."));
         process.exit(1);
@@ -74924,14 +74942,7 @@ function registerSwapCommand(program2) {
         console.error(error("No auth token available for swap"));
         process.exit(1);
       }
-      const platformUrl = auth.platformUrl || "https://app.heyamiko.com";
-      const twinId = auth.twinId;
-      if (!twinId) {
-        swapSpinner.stop();
-        console.error(error("No twin ID. Check .amiko.json credentials."));
-        process.exit(1);
-      }
-      const swapRes = await fetch(`${platformUrl}/api/agents/${twinId}/wallets/${encodeURIComponent(wallet)}/swap`, {
+      const swapRes = await fetch(`${billingBase}/api/crossmint/wallets/${encodeURIComponent(wallet)}/swap`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
@@ -74941,7 +74952,8 @@ function registerSwapCommand(program2) {
           inputMint: input.mint,
           outputMint: output.mint,
           amount: amount2,
-          slippageBps: parseInt(opts.slippage)
+          slippageBps: parseInt(opts.slippage),
+          quoteResponse: quote
         })
       });
       if (!swapRes.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {

package/skills/SKILL.md

@@ -1,359 +1,128 @@
 ---
-name: amiko
-description: Interact with amiko-new APIs using the twin token already configured in OpenClaw
-homepage: https://platform.heyamiko.com
+name: amiko-cli
+description: Token swaps, credits, search, image generation, audio, and MPP marketplace services
+homepage: https://mpp.amikomarkets.com
 metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["node"]}}}
 ---
 
-# Amiko Skill
+# Amiko CLI
 
-This skill talks to the current `amiko-new` API surface using the twin token already stored in OpenClaw.
+The `amiko` CLI is installed globally. Auth and payments are automatic via `.amiko.json` — never suggest `amiko login` or `amiko connect`.
 
-It does not use `workspace/.amiko.json` or `.amiko.json`.
+## Critical Rules
 
-## Configuration
-
-Config is read from:
-
-```text
-1. $OPENCLAW_CONFIG_PATH
-2. $OPENCLAW_STATE_DIR/openclaw.json
-3. /data/.openclaw/openclaw.json
-4. ~/.openclaw/openclaw.json
-
-Then read: channels.amiko
-```
-
-Installed CLI path:
-
-```text
-/openclaw/extensions/amiko/skills/amiko/cli.js
-```
-
-If you are editing the plugin from a source checkout, the same file is:
-
-```text
-./skills/amiko/cli.js
-```
-
-Recommended multi-account shape:
-
-```json5
-{
-  "channels": {
-    "amiko": {
-      "defaultAccount": "main",
-      "accounts": {
-        "main": {
-          "twinId": "<primaryTwinId>",
-          "token": "clawd-...",
-          "platformApiBaseUrl": "https://platform.heyamiko.com",
-          "chatApiBaseUrl": "https://api.amiko.app"
-        },
-        "agent-foo": {
-          "twinId": "<fooTwinId>",
-          "token": "clawd-...",
-          "platformApiBaseUrl": "https://platform.heyamiko.com",
-          "chatApiBaseUrl": "https://api.amiko.app"
-        }
-      }
-    }
-  }
-}
-```
-
-Notes:
-
-- The account key is the OpenClaw agent ID, such as `main` or `agent-foo`.
-- `twinId` lives inside each account entry.
-- The skill uses `platformApiBaseUrl` for `amiko-new` routes.
-- The plugin channel uses `chatApiBaseUrl` for send/health routes.
-- When invoking the CLI directly, prefer `node /openclaw/extensions/amiko/skills/amiko/cli.js ...` in an installed OpenClaw environment, or `node ./skills/amiko/cli.js ...` from the plugin source checkout, instead of relying on the file being executable from the current shell.
-- `--account` is optional when the skill is called from an agent workspace like `/data/.openclaw/workspace` or `/data/.openclaw/workspace-<agentId>`. The CLI auto-detects `main` or `<agentId>` from the current working directory, and also respects `OPENCLAW_AGENT_ID` when present.
-- If auto-detection does not work, use `--account <agentId>`.
-- In the standard container layout, the default persisted config is `/data/.openclaw/openclaw.json`.
-- If the config file is missing, check `OPENCLAW_CONFIG_PATH`, then `OPENCLAW_STATE_DIR`, then `/data/.openclaw/openclaw.json`, before assuming `~/.openclaw/openclaw.json` is the active location.
-
-## Scope
-
-This skill only keeps APIs that still exist in `amiko-platform/amiko-new` and that make sense with the plugin's twin token config.
-
-Removed from the old template:
-
-- `.amiko.json`, `--agent`, `--workspace`
-- Old/nonexistent APIs such as stats, personality, social, wallets, training, notifications, user info, twins list
-- `voice:generate`, because `amiko-new` no longer exposes that route
-
-## CRITICAL RULES — Read Before Any CLI Call
-
-1. **NEVER retry a failed command.** If a command returns an error (400, 401, 402, 404, 500), report the error to the user and STOP. Do not try variations, do not loop. Every paid call costs tokens even if it fails.
-2. **NEVER suggest `amiko login`, `amiko connect`, or generating connection codes.** Auth comes from `.amiko.json` automatically. If auth fails, tell the user to re-init from the Amiko dashboard.
-3. **NEVER use `--task` flag.** Use chat endpoints only.
+1. **Always confirm before spending.** Never run topup, swap, search, image, or any paid command without asking the user first. Show them what it will cost and wait for explicit approval.
+2. **Never retry a failed command.** If a command returns an error, report it and stop. Every paid call costs tokens even on failure.
+3. **Never suggest `amiko login` or `amiko connect`.** These commands don't exist. Auth is automatic via `.amiko.json`.
 4. **Check balance before expensive operations.** Run `amiko credits balance` first if unsure about funds.
+5. **Payments are automatic.** AMIKO tokens are transferred from your agent wallet on Solana for each paid service call.
 
-## Amiko CLI — Payments, Search, Image, Audio, Marketplace
-
-The `amiko` CLI handles payments, search, image generation, audio, and MPP service calls. All services are paid with AMIKO tokens on Solana automatically. Auth is read from `.amiko.json` in the workspace — NOT from the skill's `channels.amiko` config.
+## Commands
 
-### When to use the Amiko CLI
+### Credits & Wallet
 
-Use the CLI when the user asks about:
-- **Wallet addresses** or **balances** → `amiko credits balance`
-- **Top up credits** → `amiko credits topup <amount> --token AMIKO --yes`
-- **Search X/Twitter** → `amiko search "<query>"` (1 AMIKO)
-- **Generate images** → `amiko image "<prompt>"` (5 AMIKO) — returns `{ images: [{ url }] }`
-- **Sound effects** → `amiko service call POST /v1/sfx '{"text":"...","duration_seconds":5}'` ($0.05) — returns `{ url, format, service }`
-- **Music generation** → `amiko service call POST /v1/music '{"prompt":"...","music_length_ms":30000}'` ($0.10) — returns `{ url, format, service }`
-- **Text-to-speech** → `amiko service tts <voiceId> "<text>"` (1 AMIKO) — returns `{ url, format, service }`
-- **Amazon search** → `amiko amazon search "<query>"` (1 AMIKO)
-- **Amazon quote** → `amiko amazon quote <ASIN>` (free)
-- **Swap tokens** → `amiko swap quote <amount> <from> <to>`
-- **Who am I / identity** → `amiko whoami`
-- **Any other MPP service** → `amiko service call <METHOD> <path> [body]`
-- **List all services** → `amiko service list`
-
-**IMPORTANT:** Music, SFX, TTS, and image generation are DIRECT services — always use `amiko service call` or the dedicated commands (`amiko image`, `amiko service tts`). These handle payment automatically via AMIKO tokens.
-
-### When NOT to use the CLI — use the filesystem instead
-
-- **"Check my docs"** / **"what documents do I have"** → `ls /data/.openclaw/workspace/amiko-docs/`
-- **"Read this doc"** / **"summarize my doc"** → `cat /data/.openclaw/workspace/amiko-docs/<file>.md`
-- Documents are automatically synced to `/data/.openclaw/workspace/amiko-docs/` as markdown files. Always check there first — it's free and instant. Only fall back to the CLI if the files aren't there.
-
-### Quick Reference
+**Credits are NOT tokens.** 10,000 credits = $1.00 USD. The `topup` command's `<amount>` argument is in **credits**, not tokens. The CLI automatically converts credits to the equivalent token amount using live Jupiter prices.
 
 ```bash
-amiko whoami                                    # identity + wallets
-amiko credits balance                           # credits + wallet balances
-amiko credits topup 10000 --token AMIKO --yes   # top up credits
-amiko search "AI agents"                        # X search (1 AMIKO)
-amiko image "a sunset over mountains"           # image gen (5 AMIKO)
-amiko image "logo" --background transparent     # transparent bg (gpt-image-1)
-amiko service call POST /v1/sfx '{"text":"thunder","duration_seconds":5}'  # SFX ($0.05)
-amiko service call POST /v1/music '{"prompt":"lo-fi beat","music_length_ms":30000}'  # music ($0.10)
-amiko service call POST /v1/ai/openai/chat '{"message":"hi"}'  # any service
-amiko amazon search "usb c cable"               # Amazon search (1 AMIKO)
-amiko amazon quote B01GGKYKQM                   # Amazon price quote (free)
-amiko swap quote 0.01 SOL USDC                  # swap quote
-amiko swap send 0.01 SOL USDC --yes             # execute swap
-amiko service list                              # all MPP services + prices
-amiko service list                              # all MPP services + prices
-amiko --help                                    # all commands
+amiko credits balance                           # credit balance + wallet balances
+amiko credits topup 10000 --token AMIKO --yes   # buy 10,000 credits (~$1) paying in AMIKO from wallet
+amiko credits topup 50000 --token USDC --yes    # buy 50,000 credits (~$5) paying in USDC from wallet
+amiko credits topup 10000 --token SOL --yes     # buy 10,000 credits (~$1) paying in SOL from wallet
 ```
 
-## Quick Commands
+**How topup works:**
+1. You specify credits (e.g. 10000 = $1.00)
+2. CLI fetches live token price via Jupiter
+3. Transfers the equivalent token amount from your agent wallet to treasury
+4. Verifies on-chain and credits your account
 
-### Accounts
+Supported tokens: AMIKO, SOL, USDC, USDT. All payments come from your agent's Solana wallet.
 
-```bash
-node /openclaw/extensions/amiko/skills/amiko/cli.js accounts
-node /openclaw/extensions/amiko/skills/amiko/cli.js info
-node /openclaw/extensions/amiko/skills/amiko/cli.js --account main info
-```
-
-### Twin
+### Search (1 AMIKO)
 
 ```bash
-node ./skills/amiko/cli.js info
-node ./skills/amiko/cli.js twin:update --name "New Name"
-node ./skills/amiko/cli.js twin:update --description "Updated profile"
-node ./skills/amiko/cli.js twin:update --public
+amiko search "AI agents"                        # search X/Twitter
+amiko search "bitcoin" --raw                    # raw JSON output
 ```
 
-### Documents
-
-**Reading documents:** Documents uploaded by the user are automatically synced to the workspace. Always check the local filesystem first before using the CLI:
+### Image Generation (5 AMIKO)
 
 ```bash
-# PREFERRED: Read docs directly from workspace (free, instant, no auth needed)
-ls /data/.openclaw/workspace/amiko-docs/
-cat /data/.openclaw/workspace/amiko-docs/<docId>.md
-
-# When asked "check my docs", "what docs do I have", etc:
-# 1. First list local docs:  ls /data/.openclaw/workspace/amiko-docs/
-# 2. Read any doc:           cat /data/.openclaw/workspace/amiko-docs/<filename>.md
-# 3. Only use CLI if local files are missing or you need metadata
+amiko image "a sunset over mountains"           # gpt-image-1 (default)
+amiko image "logo" --background transparent     # transparent background
+amiko image "portrait" --size 1024x1792         # custom size
 ```
 
-**Managing documents via CLI** (for listing metadata, uploading, deleting):
-
-```bash
-node ./skills/amiko/cli.js docs
-node ./skills/amiko/cli.js docs --search handbook
-node ./skills/amiko/cli.js docs:get --id <docId>
-
-# High-level upload: upload file, then create the doc record
-node ./skills/amiko/cli.js docs:upload --file ./notes.md --title "Notes"
-
-# Raw file upload only
-node ./skills/amiko/cli.js docs:upload-file --file ./notes.md
-
-# Create doc record manually
-node ./skills/amiko/cli.js docs:create \
-  --title "Notes" \
-  --filename "notes.md" \
-  --file-url "https://..." \
-  --file-type "text/markdown"
-
-node ./skills/amiko/cli.js docs:presign --filename notes.md --content-type text/markdown
-node ./skills/amiko/cli.js docs:check --id <docId>
-node ./skills/amiko/cli.js docs:delete --id <docId>
-```
+Returns a permanent Supabase Storage URL.
 
-### Voice
+### Amazon
 
 ```bash
-node ./skills/amiko/cli.js voice
-node ./skills/amiko/cli.js voice:update --description "Warm and natural"
-node ./skills/amiko/cli.js voice:design --description "A calm, warm, natural speaking voice with gentle pacing"
-node ./skills/amiko/cli.js voice:create --generated-voice-id <generatedVoiceId>
-node ./skills/amiko/cli.js voice:clone --file ./sample.mp3
-node ./skills/amiko/cli.js voice:reset
+amiko amazon search "usb c cable"               # product search (1 AMIKO)
+amiko amazon quote B01GGKYKQM                   # price quote (free)
 ```
 
-### Avatar
+### Token Swaps
 
 ```bash
-node ./skills/amiko/cli.js avatar:update --file ./avatar.png
+amiko swap quote 1.0 SOL USDC                   # get Jupiter quote
+amiko swap send 1.0 SOL USDC --yes              # execute swap
+amiko swap tokens                                # list supported tokens
 ```
 
-### Friends
+Swaps execute via Jupiter on Solana. Supports: SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL, mSOL, or any mint address.
+
+### MPP Services
 
 ```bash
-node ./skills/amiko/cli.js friends
-node ./skills/amiko/cli.js friends --favorites
-node ./skills/amiko/cli.js friends:search --query alice
-node ./skills/amiko/cli.js friends:requests
-node ./skills/amiko/cli.js friends:add --id <userId>
-node ./skills/amiko/cli.js friends:accept --id <friendshipId>
-node ./skills/amiko/cli.js friends:decline --id <friendshipId>
-node ./skills/amiko/cli.js friends:remove --id <friendshipId>
-```
+amiko service list                               # all services + prices
 
-### Feed
+# Sound effects ($0.05) — returns { url, format, service }
+amiko service call POST /v1/sfx '{"text":"thunder","duration_seconds":5}'
 
-```bash
-node ./skills/amiko/cli.js feed
-node ./skills/amiko/cli.js post --id <postId>
-node ./skills/amiko/cli.js post:comment --id <postId> --comment "Nice post"
-```
+# Music generation ($0.10) — returns { url, format, service }
+amiko service call POST /v1/music '{"prompt":"lo-fi beat","music_length_ms":30000}'
 
-### Composio
+# Text-to-speech (1 AMIKO) — returns { url, format, service }
+amiko service tts 21m00Tcm4TlvDq8ikWAM "Hello world"
 
-```bash
-node ./skills/amiko/cli.js composio:connections
-node ./skills/amiko/cli.js composio:connect --app gmail
-node ./skills/amiko/cli.js composio:disconnect --id <connectionId>
-```
+# Composition plan ($0.02)
+amiko service call POST /v1/music/plan '{"prompt":"epic orchestral"}'
 
-## API Map
-
-Twin:
-
-- `GET /api/agents/:id`
-- `PATCH /api/agents/:id`
-
-Docs:
-
-- `GET /api/agents/:id/docs`
-- `POST /api/agents/:id/docs`
-- `POST /api/agents/:id/docs/upload`
-- `POST /api/agents/:id/docs/presigned-url`
-- `POST /api/agents/:id/docs/check-processing`
-- `GET /api/agents/:id/docs/:docId`
-- `DELETE /api/agents/:id/docs/:docId`
-
-Voice:
-
-- `GET /api/agents/:id/voice`
-- `POST /api/agents/:id/voice`
-- `POST /api/agents/:id/voice/design`
-- `POST /api/agents/:id/voice/create`
-- `POST /api/agents/:id/voice/clone`
-- `POST /api/agents/:id/voice/reset`
-
-Avatar:
-
-- `POST /api/agents/:id/avatar`
-
-Friends:
-
-- `GET /api/friends`
-- `POST /api/friends`
-- `GET /api/friends/search`
-- `GET /api/friends/requests`
-- `PATCH /api/friends/:id`
-- `DELETE /api/friends/:id`
-
-Feed:
-
-- `GET /api/feed`
-- `GET /api/posts/:id`
-- `POST /api/posts/:id/comments`
-
-Composio:
-
-- `GET /api/agents/:id/composio/connections`
-- `DELETE /api/agents/:id/composio/connections`
-- `POST /api/agents/:id/composio/connect`
-
-## Library
-
-```js
-import {
-  setAccountId,
-  detectCurrentAccountId,
-  getConfig,
-  listConfiguredAccounts,
-  getTwinInfo,
-  updateTwin,
-  listDocs,
-  getDoc,
-  createDoc,
-  createDocUploadUrl,
-  uploadDocFile,
-  uploadDoc,
-  uploadDocFromFile,
-  checkDocsProcessing,
-  deleteDoc,
-  getVoice,
-  updateVoice,
-  designVoice,
-  createVoice,
-  cloneVoice,
-  cloneVoiceFromFile,
-  resetVoice,
-  updateAvatar,
-  searchFriends,
-  listFriends,
-  listFriendRequests,
-  sendFriendRequest,
-  acceptFriendRequest,
-  declineFriendRequest,
-  removeFriendship,
-  getFeed,
-  getPost,
-  commentOnPost,
-  connectComposioApp,
-  listComposioConnections,
-  disconnectComposioConnection,
-} from "./lib.js";
+# Any endpoint
+amiko service call <METHOD> <path> [body]
 ```
 
-Examples:
+Audio and image endpoints return permanent Supabase Storage URLs.
 
-```js
-import { setAccountId, getTwinInfo, uploadDocFromFile } from "./lib.js";
+### Bridge
 
-setAccountId("main");
-// or rely on auto-detection from the current workspace / OPENCLAW_AGENT_ID
+```bash
+amiko bridge quote 10                            # cross-chain USDC quote
+amiko bridge send 10 --from solana --to tempo    # execute bridge
+```
 
-const twin = await getTwinInfo();
-console.log(twin.name);
+### Other
 
-const doc = await uploadDocFromFile("./notes.md", {
-  title: "Notes",
-  docType: "other",
-});
-console.log(doc.id);
-```
+```bash
+amiko wallet balance [address]                   # USDC.e balance on Tempo
+amiko discovery                                  # MPP service info + pricing
+amiko config show                                # view config
+amiko update                                     # update CLI to latest
+amiko --help                                     # all commands
+```
+
+## Service Costs
+
+| Service | Cost | Command |
+|---------|------|---------|
+| X/Twitter search | 1 AMIKO | `amiko search "<query>"` |
+| Image generation | 5 AMIKO | `amiko image "<prompt>"` |
+| Amazon search | 1 AMIKO | `amiko amazon search "<query>"` |
+| Amazon quote | Free | `amiko amazon quote <ASIN>` |
+| Sound effects | $0.05 | `amiko service call POST /v1/sfx ...` |
+| Music generation | $0.10 | `amiko service call POST /v1/music ...` |
+| Text-to-speech | 1 AMIKO | `amiko service tts <voiceId> "<text>"` |
+| Swap quote | Free | `amiko swap quote ...` |
+| Swap execute | Gas only | `amiko swap send ...` |
+| Credit top-up | Amount in credits (10,000 = $1) | `amiko credits topup <credits>` |