@heyamiko/amiko-cli 0.9.9 → 0.10.0

package/package.json

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

package/skills/SKILL.md

@@ -7,11 +7,28 @@ metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["node"]}}}
 
 # Amiko CLI
 
-## How to invoke
+## How to invoke — ALWAYS use your shell-execution tool
 
-Run `amiko <command>` via your **shell execution tool** (e.g. `bash`). This skill is documentation, not a callable tool. **Do NOT** try to call `amiko_cli`, `amiko-cli`, `amiko`, or this skill's name as a tool — no such tool exists. The only working invocation is the shell command `amiko`.
+Call your shell tool (your runtime calls it `bash`, `shell`, `run`, or similar) and run `amiko <subcommand>`. Amiko is a shell program, not a callable tool. Always go through the shell tool.
 
-The `amiko` CLI is installed globally. If you run it from inside your workspace folder, you're automatically authenticated — never suggest `amiko login` or `amiko connect`.
+### Examples — copy this pattern
+
+| User asks | You run |
+|---|---|
+| "what's my balance?" | shell → `amiko credits balance` |
+| "top up 10k credits with AMIKO" | shell → `amiko credits topup 10000 --token AMIKO --yes` |
+| "swap 1 SOL to USDC" | shell → `amiko wallets swap quote 1 SOL USDC` (then send with `--yes` after approval) |
+| "did anyone DM me?" | shell → `amiko conversation list` |
+| "any notifications?" | shell → `amiko notifications list --unread` |
+| "search memory for X" | shell → `amiko memory search "X"` |
+| "what can amiko do?" | shell → `amiko --help` |
+
+The CLI is installed globally and is pre-authenticated when you're inside your workspace folder. Never suggest `amiko login` or `amiko connect`.
+
+### Failure modes to avoid
+
+- A tool named `amiko_cli` / `amiko-cli` / `amiko` (or this skill's name) does **not** exist. The only path is the shell tool above. If you try to call any of those as a tool, the gateway returns `Tool ... not found` — and if you retry with name variants, you burn credits on every retry. Don't retry. Re-route through the shell tool.
+- Do not invent intermediate "amiko" tools (`amiko.balance`, `amiko.credits`, etc.). Every Amiko action goes through one path: shell tool → `amiko <subcommand>`.
 
 ## Top-level commands at a glance
 
@@ -116,8 +133,8 @@ amiko wallets transfer --to <addr> --amount 100 --token amiko --yes  # send toke
 amiko wallets swap quote 1.0 SOL USDC                # Jupiter quote (free)
 amiko wallets swap send 1.0 SOL USDC --yes           # --wallet defaults to your Solana wallet
 amiko wallets swap tokens                            # supported tokens list
-amiko wallets bridge quote 10 --from solana --to tempo --recipient <addr>
-amiko wallets bridge send 10 --from solana --to tempo --recipient <addr> --yes
+amiko wallets bridge quote 10 --from solana --to base --recipient <addr>
+amiko wallets bridge send 10 --from solana --to base --recipient <addr> --yes
 amiko wallets bridge status <txHash>
 amiko wallets bridge routes
 amiko wallets bridge limits