@heyamiko/amiko-cli 0.9.0-beta.5 → 0.9.0-beta.7

package/README.md

@@ -1,4 +1,4 @@
-# @heyamiko/amiko-cli (v0.9.0-beta.0)
+# @heyamiko/amiko-cli (v0.9.0-beta.7)
 
 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.
 
@@ -294,13 +294,13 @@ src/
 │   ├── config.ts         # config management
 │   ├── update.ts         # self-update
 │   ├── accounts.ts       # accounts, info (twin identity readout)
-│   ├── twin.ts           # twin:update (name/description/public)
+│   ├── 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
+│   ├── 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:create, post:comment
-│   └── composio.ts       # composio:connect, composio:disconnect
+│   ├── feed.ts           # feed, post create, post comment
+│   └── composio.ts       # composio connect, composio disconnect
 └── lib/
     ├── config.ts          # defaults + resolved auth wrapper
     ├── agent-config.ts    # .amiko.json reader + auth resolution
@@ -323,48 +323,48 @@ The CLI also manages the twin's identity, documents, voice, avatar, friends, fee
 # 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)
+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
+amiko docs list                         # 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
+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
+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
+amiko friends list                      # 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:create --content "hello from the CLI"           # public post
-amiko post:create --content "private note" --visibility private
-amiko post:create --content "look" --media https://...jpg
-amiko post:comment --id <postId> --comment "great post"
-amiko post:comment --id <postId> --comment "nice!" --media https://...jpg
+amiko post create --content "hello from the CLI"           # public post
+amiko post create --content "private note" --visibility private
+amiko post create --content "look" --media https://...jpg
+amiko post comment --id <postId> --comment "great post"
+amiko post comment --id <postId> --comment "nice!" --media https://...jpg
 
 # Composio
-amiko composio:connect --app gmail      # prints OAuth URL
-amiko composio:disconnect --app gmail --yes
+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.
+**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
 
@@ -382,6 +382,10 @@ npm publish
 
 ## Changelog
 
+### 0.9.0-beta.7
+
+- **Breaking**: colon-style commands are now subcommand groups. `twin:update` → `twin update`, `docs:upload` → `docs upload`, `voice:design` → `voice design`, `avatar:update` → `avatar update`, `friends:add` → `friends add`, `post:create` → `post create`, `composio:connect` → `composio connect`, etc. No aliases — scripts and skills that used the old names must be updated. Bare `docs` and `friends` now require `list` (e.g. `amiko docs list`).
+
 ### 0.9.0-beta.0
 
 - **Breaking**: auth simplified to `.amiko.json` + `amikoTwinToken` only. Removed `apiKey`, `privyToken`, `platformKey`, `connectedKeyId`, `agentWallets`, and `~/.amiko/config.json`.

package/dist/index.js

@@ -19570,6 +19570,71 @@ function detectPackageManager() {
     return "npm";
   }
 }
+function isPrerelease(v) {
+  return v.includes("-");
+}
+function compareSemver(a, b) {
+  const [aMain, aPre] = a.split("-", 2);
+  const [bMain, bPre] = b.split("-", 2);
+  const an = aMain.split(".").map(Number);
+  const bn = bMain.split(".").map(Number);
+  for (let i = 0;i < 3; i++) {
+    if ((an[i] ?? 0) !== (bn[i] ?? 0))
+      return (an[i] ?? 0) > (bn[i] ?? 0) ? 1 : -1;
+  }
+  if (!aPre && !bPre)
+    return 0;
+  if (!aPre)
+    return 1;
+  if (!bPre)
+    return -1;
+  const ap = aPre.split(".");
+  const bp = bPre.split(".");
+  for (let i = 0;i < Math.max(ap.length, bp.length); i++) {
+    const x = ap[i];
+    const y = bp[i];
+    if (x === undefined)
+      return -1;
+    if (y === undefined)
+      return 1;
+    const xn = /^\d+$/.test(x) ? Number(x) : NaN;
+    const yn = /^\d+$/.test(y) ? Number(y) : NaN;
+    if (!isNaN(xn) && !isNaN(yn)) {
+      if (xn !== yn)
+        return xn > yn ? 1 : -1;
+    } else if (!isNaN(xn)) {
+      return -1;
+    } else if (!isNaN(yn)) {
+      return 1;
+    } else if (x !== y) {
+      return x > y ? 1 : -1;
+    }
+  }
+  return 0;
+}
+async function fetchDistTags(pkg) {
+  const url2 = `https://registry.npmjs.org/-/package/${encodeURIComponent(pkg)}/dist-tags`;
+  const res = await fetch(url2);
+  if (!res.ok)
+    throw new Error(`registry responded ${res.status}`);
+  return await res.json();
+}
+async function resolveTargetVersion(pkg, currentVersion) {
+  if (!isPrerelease(currentVersion)) {
+    return { version: "latest", channel: "latest" };
+  }
+  const tags = await fetchDistTags(pkg);
+  const latest = tags.latest;
+  const beta = tags.beta;
+  if (latest && beta) {
+    return compareSemver(latest, beta) >= 0 ? { version: latest, channel: "latest" } : { version: beta, channel: "beta" };
+  }
+  if (beta)
+    return { version: beta, channel: "beta" };
+  if (latest)
+    return { version: latest, channel: "latest" };
+  return { version: "latest", channel: "latest" };
+}
 var DATA_CLI = "/data/.amiko-cli";
 var NPM_GLOBAL_CANDIDATES = [
   "/usr/local/lib/node_modules/@heyamiko/amiko-cli",
@@ -19615,17 +19680,21 @@ function registerUpdateCommand(program2) {
     console.log(heading("Update"));
     console.log(label("Current", `v${currentVersion}`));
     console.log(label("Package manager", pm));
+    let target;
+    try {
+      target = await resolveTargetVersion(pkg, currentVersion);
+    } catch {
+      target = { version: "latest", channel: "latest" };
+    }
+    const installSpec = `${pkg}@${target.version}`;
+    console.log(label("Target", target.version === "latest" ? "latest" : `${target.version} (${target.channel})`));
     console.log("");
-    const spinner = ora("Installing latest version...").start();
+    const spinner = ora(`Installing ${installSpec}...`).start();
     try {
       if (pm === "bun") {
-        execFileSync2("bun", ["install", "-g", `${pkg}@latest`], {
-          stdio: "pipe"
-        });
+        execFileSync2("bun", ["install", "-g", installSpec], { stdio: "pipe" });
       } else {
-        execFileSync2("npm", ["install", "-g", `${pkg}@latest`], {
-          stdio: "pipe"
-        });
+        execFileSync2("npm", ["install", "-g", installSpec], { stdio: "pipe" });
       }
       spinner.stop();
       let syncedTwin = false;
@@ -19655,7 +19724,7 @@ function registerUpdateCommand(program2) {
       console.error(error("Auto-update failed."));
       console.log("");
       console.log(dim("Try manually:"));
-      console.log(dim(`  ${pm} install -g ${pkg}@latest`));
+      console.log(dim(`  ${pm} install -g ${installSpec}`));
       process.exit(1);
     }
   });
@@ -20379,7 +20448,7 @@ function parseBool(raw, flag) {
   throw new Error(`${flag} must be true or false, got "${raw}"`);
 }
 function registerTwinCommand(program2) {
-  program2.command("twin:update").description("Update twin name, description, or public visibility").option("--name <name>", "Display name").option("--description <text>", "Description").option("--public <bool>", "Public visibility (true/false)").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation when changing visibility").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("update").description("Update twin name, description, or public visibility").option("--name <name>", "Display name").option("--description <text>", "Description").option("--public <bool>", "Public visibility (true/false)").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation when changing visibility").option("--json", "Output as JSON").action(async (opts) => {
     if (opts.name === undefined && opts.description === undefined && opts.public === undefined) {
       console.error(error("Pass at least one of --name, --description, --public"));
       process.exit(1);
@@ -20414,7 +20483,7 @@ function registerTwinCommand(program2) {
         action: `Set twin visibility to ${next ? "PUBLIC" : "PRIVATE"}`,
         detail: next ? "Anyone on amiko.com will be able to find and chat with this twin." : "The twin will no longer be discoverable.",
         yes: opts.yes,
-        commandExample: `amiko twin:update --public ${next}`
+        commandExample: `amiko twin update --public ${next}`
       });
     }
     const spinner = opts.json ? null : ora("Updating twin...").start();
@@ -20562,7 +20631,7 @@ function fmtBytes(n) {
   return `${v.toFixed(v >= 10 ? 0 : 1)} ${units[i]}`;
 }
 function registerDocsCommand(program2) {
-  program2.command("docs").description("List uploaded documents for a twin").option("--twin <idOrName>", "Target twin id or name").option("--limit <n>", "Max results", "50").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("list").description("List uploaded documents for a twin").option("--twin <idOrName>", "Target twin id or name").option("--limit <n>", "Max results", "50").option("--json", "Output as JSON").action(async (opts) => {
     const { twinId, auth } = twinFromFlag(opts);
     const spinner = opts.json ? null : ora("Loading documents...").start();
     try {
@@ -20598,7 +20667,7 @@ function registerDocsCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("docs:upload <source>").description("Upload a document (path | https URL | - for stdin)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--title <title>", "Document title (defaults to filename)").option("--description <text>", "Document description").option("--doc-type <type>", "Document type (e.g. 'other', 'memory')", "other").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
+  program2.command("upload <source>").description("Upload a document (path | https URL | - for stdin)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--title <title>", "Document title (defaults to filename)").option("--description <text>", "Document description").option("--doc-type <type>", "Document type (e.g. 'other', 'memory')", "other").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
     const { twinId, auth } = twinFromFlag(opts);
     const spinner = opts.json ? null : ora("Reading input...").start();
     try {
@@ -20649,13 +20718,13 @@ function registerDocsCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("docs:delete <docId>").description("Delete a document").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (docId, opts) => {
+  program2.command("delete <docId>").description("Delete a document").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (docId, opts) => {
     const { twinId, auth } = twinFromFlag(opts);
     await confirmDestructive({
       action: `Delete document ${docId}`,
       detail: "This will remove the document and its embeddings from the twin's RAG.",
       yes: opts.yes,
-      commandExample: `amiko docs:delete ${docId}`
+      commandExample: `amiko docs delete ${docId}`
     });
     const spinner = opts.json ? null : ora("Deleting document...").start();
     try {
@@ -20668,7 +20737,7 @@ function registerDocsCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("docs:presign <source>").description("Get a presigned upload URL for a document (no upload)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename used in the request").option("--json", "Output as JSON").action(async (source, opts) => {
+  program2.command("presign <source>").description("Get a presigned upload URL for a document (no upload)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename used in the request").option("--json", "Output as JSON").action(async (source, opts) => {
     const { twinId, auth } = twinFromFlag(opts);
     const filename = opts.name ?? (source === "-" ? "stdin" : source.split("/").pop() ?? source);
     try {
@@ -20696,7 +20765,7 @@ function twinFromFlag2(opts) {
   }
 }
 function registerVoiceCommand(program2) {
-  program2.command("voice:design").description("Design a voice from a text description").requiredOption("--description <text>", "Voice description (min 20 chars)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("design").description("Design a voice from a text description").requiredOption("--description <text>", "Voice description (min 20 chars)").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
     if (opts.description.trim().length < 20) {
       console.error(error("--description must be at least 20 characters"));
       process.exit(1);
@@ -20716,7 +20785,7 @@ function registerVoiceCommand(program2) {
           console.log(label(`#${i + 1} id`, p.generated_voice_id ?? "?"));
         }
         console.log("");
-        console.log(dim("Pick one with: amiko voice:create --sample <id>"));
+        console.log(dim("Pick one with: amiko voice create --sample <id>"));
       }, { json: opts.json });
     } catch (e) {
       spinner?.stop();
@@ -20724,7 +20793,7 @@ function registerVoiceCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("voice:create").description("Create a voice from a previously designed preview").requiredOption("--sample <id>", "generated_voice_id from voice:design").option("--description <text>", "Optional voice description").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("create").description("Create a voice from a previously designed preview").requiredOption("--sample <id>", "generated_voice_id from voice design").option("--description <text>", "Optional voice description").option("--twin <idOrName>", "Target twin id or name").option("--json", "Output as JSON").action(async (opts) => {
     const { twinId, auth } = twinFromFlag2(opts);
     const spinner = opts.json ? null : ora("Creating voice...").start();
     try {
@@ -20750,7 +20819,7 @@ function registerVoiceCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("voice:clone <source>").description("Clone a voice from an audio file (path | https URL | -)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
+  program2.command("clone <source>").description("Clone a voice from an audio file (path | https URL | -)").option("--twin <idOrName>", "Target twin id or name").option("--name <filename>", "Override filename").option("--stdin", "Read from stdin (source must be -)").option("--json", "Output as JSON").action(async (source, opts) => {
     const { twinId, auth } = twinFromFlag2(opts);
     const spinner = opts.json ? null : ora("Reading audio...").start();
     try {
@@ -20778,13 +20847,13 @@ function registerVoiceCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("voice:reset").description("Reset the twin's voice to default").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("reset").description("Reset the twin's voice to default").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
     const { twinId, auth } = twinFromFlag2(opts);
     await confirmDestructive({
       action: "Reset voice",
       detail: "This removes the custom voice. You can redesign or clone a new one later.",
       yes: opts.yes,
-      commandExample: "amiko voice:reset"
+      commandExample: "amiko voice reset"
     });
     const spinner = opts.json ? null : ora("Resetting voice...").start();
     try {
@@ -20801,7 +20870,7 @@ function registerVoiceCommand(program2) {
 
 // src/commands/avatar.ts
 function registerAvatarCommand(program2) {
-  program2.command("avatar:update").description("Update twin avatar image (path | https URL | - for stdin)").requiredOption("--file <source>", "Image source").option("--twin <idOrName>", "Target twin id or name").option("--stdin", "Read from stdin (file must be -)").option("--name <filename>", "Override filename").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("update").description("Update twin avatar image (path | https URL | - for stdin)").requiredOption("--file <source>", "Image source").option("--twin <idOrName>", "Target twin id or name").option("--stdin", "Read from stdin (file must be -)").option("--name <filename>", "Override filename").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
     const config2 = loadConfig();
     const auth = resolveAuth();
     let twinId;
@@ -20818,7 +20887,7 @@ function registerAvatarCommand(program2) {
       action: "Replace twin avatar",
       detail: "The twin's public avatar will change immediately.",
       yes: opts.yes,
-      commandExample: `amiko avatar:update --file ${opts.file}`
+      commandExample: `amiko avatar update --file ${opts.file}`
     });
     const spinner = opts.json ? null : ora("Reading image...").start();
     try {
@@ -20860,7 +20929,7 @@ function registerAvatarCommand(program2) {
 
 // src/commands/friends.ts
 function registerFriendsCommand(program2) {
-  program2.command("friends").description("List friends").option("--type <user|twin>", "Filter by friend type").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("list").description("List friends").option("--type <user|twin>", "Filter by friend type").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Loading friends...").start();
     try {
@@ -20891,7 +20960,7 @@ function registerFriendsCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("friends:add").description("Send a friend request to a user by id").requiredOption("--id <userId>", "Target user id").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("add").description("Send a friend request to a user by id").requiredOption("--id <userId>", "Target user id").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Sending friend request...").start();
     try {
@@ -20911,7 +20980,7 @@ function registerFriendsCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("friends:accept <friendshipId>").description("Accept a pending friend request").option("--json", "Output as JSON").action(async (friendshipId, opts) => {
+  program2.command("accept <friendshipId>").description("Accept a pending friend request").option("--json", "Output as JSON").action(async (friendshipId, opts) => {
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Accepting...").start();
     try {
@@ -20924,11 +20993,11 @@ function registerFriendsCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("friends:remove <friendshipId>").description("Remove a friend").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (friendshipId, opts) => {
+  program2.command("remove <friendshipId>").description("Remove a friend").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (friendshipId, opts) => {
     await confirmDestructive({
       action: `Remove friend ${friendshipId}`,
       yes: opts.yes,
-      commandExample: `amiko friends:remove ${friendshipId}`
+      commandExample: `amiko friends remove ${friendshipId}`
     });
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Removing...").start();
@@ -20987,7 +21056,9 @@ function registerFeedCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("post:create").description("Create a post on your feed").requiredOption("--content <text>", "Post body (required, non-empty)").option("--visibility <public|private>", "Post visibility", "public").option("--media <url...>", "One or more media URLs").option("--json", "Output as JSON").action(async (opts) => {
+}
+function registerPostCommand(program2) {
+  program2.command("create").description("Create a post on your feed").requiredOption("--content <text>", "Post body (required, non-empty)").option("--visibility <public|private>", "Post visibility", "public").option("--media <url...>", "One or more media URLs").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const visibility = opts.visibility === "private" ? "private" : "public";
     const spinner = opts.json ? null : ora("Publishing post...").start();
@@ -21015,7 +21086,7 @@ function registerFeedCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("post:comment").description("Comment on a post").requiredOption("--id <postId>", "Target post id").requiredOption("--comment <text>", "Comment body").option("--media <url...>", "One or more media URLs to attach").option("--twin <idOrName>", "Post as this twin (agent mode)").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("comment").description("Comment on a post").requiredOption("--id <postId>", "Target post id").requiredOption("--comment <text>", "Comment body").option("--media <url...>", "One or more media URLs to attach").option("--twin <idOrName>", "Post as this twin (agent mode)").option("--json", "Output as JSON").action(async (opts) => {
     const config2 = loadConfig();
     const auth = resolveAuth();
     let twinId;
@@ -21067,7 +21138,7 @@ function twinFromFlag3(opts) {
   }
 }
 function registerComposioCommand(program2) {
-  program2.command("composio:connect").description("Start Composio OAuth for an app (gmail, github, ...)").requiredOption("--app <slug>", "App name (e.g. gmail)").option("--twin <idOrName>", "Target twin id or name").option("--redirect <url>", "Override OAuth redirect URL").option("--force", "Force reconnect if already connected").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("connect").description("Start Composio OAuth for an app (gmail, github, ...)").requiredOption("--app <slug>", "App name (e.g. gmail)").option("--twin <idOrName>", "Target twin id or name").option("--redirect <url>", "Override OAuth redirect URL").option("--force", "Force reconnect if already connected").option("--json", "Output as JSON").action(async (opts) => {
     const { twinId, auth } = twinFromFlag3(opts);
     const spinner = opts.json ? null : ora(`Connecting ${opts.app}...`).start();
     try {
@@ -21103,13 +21174,13 @@ function registerComposioCommand(program2) {
       process.exit(1);
     }
   });
-  program2.command("composio:disconnect").description("Disconnect a Composio app for the twin").requiredOption("--app <slug>", "App name (e.g. gmail)").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
+  program2.command("disconnect").description("Disconnect a Composio app for the twin").requiredOption("--app <slug>", "App name (e.g. gmail)").option("--twin <idOrName>", "Target twin id or name").option("--yes", "Skip confirmation").option("--json", "Output as JSON").action(async (opts) => {
     const { twinId, auth } = twinFromFlag3(opts);
     await confirmDestructive({
       action: `Disconnect ${opts.app}`,
       detail: "The twin will lose access to the app's tools until reconnected.",
       yes: opts.yes,
-      commandExample: `amiko composio:disconnect --app ${opts.app}`
+      commandExample: `amiko composio disconnect --app ${opts.app}`
     });
     const spinner = opts.json ? null : ora("Finding connection...").start();
     try {
@@ -21235,6 +21306,13 @@ var program2 = new Command;
 program2.name("amiko").description("Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace services").version(PKG_VERSION);
 var market = program2.command("market").description("MPP marketplace — discover and call paid AMIKO services");
 var wallets = program2.command("wallets").description("Manage twin wallets — list, swap, bridge");
+var twin = program2.command("twin").description("Update twin identity (name, description, visibility)");
+var docs = program2.command("docs").description("Manage twin RAG documents — list, upload, delete, presign");
+var voice = program2.command("voice").description("Manage twin voice — design, create, clone, reset");
+var avatar = program2.command("avatar").description("Manage twin avatar image");
+var friends = program2.command("friends").description("Manage friendships — list, add, accept, remove");
+var post = program2.command("post").description("Create posts and comments on the feed");
+var composio = program2.command("composio").description("Manage Composio app connections");
 registerCreditsCommand(program2);
 registerSearchCommand(market);
 registerImageCommand(market);
@@ -21248,11 +21326,12 @@ registerServicesCommand(market);
 registerDiscoveryCommand(market);
 registerUpdateCommand(program2);
 registerAccountsCommand(program2);
-registerTwinCommand(program2);
-registerDocsCommand(program2);
-registerVoiceCommand(program2);
-registerAvatarCommand(program2);
-registerFriendsCommand(program2);
+registerTwinCommand(twin);
+registerDocsCommand(docs);
+registerVoiceCommand(voice);
+registerAvatarCommand(avatar);
+registerFriendsCommand(friends);
 registerFeedCommand(program2);
-registerComposioCommand(program2);
+registerPostCommand(post);
+registerComposioCommand(composio);
 program2.parse();

package/package.json

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

package/skills/SKILL.md

@@ -21,11 +21,11 @@ The top level has three groups:
 - `amiko wallets <cmd>` — wallet operations (list, balance, swap, bridge)
 - `amiko credits <cmd>` — credit balance and topup
 
-Plus flat commands: `config`, `update`, `accounts`, `info`, `twin:*`, `docs*`, `voice:*`, `avatar:*`, `friends*`, `feed`, `post:*`, `composio:*`.
+Plus subcommand groups: `twin <action>`, `docs <action>`, `voice <action>`, `avatar <action>`, `friends <action>`, `post <action>`, `composio <action>`. Plus flat commands: `config`, `update`, `accounts`, `info`, `feed`.
 
 ## Critical Rules
 
-1. **Every paid / value-moving command is hard-gated on `--yes` in a non-interactive shell.** The CLI *refuses* to run `market image`, `market search`, `market amazon search`, `market service call`, `market service tts`, `market service stt`, `market service chat`, `credits topup`, `wallets swap send`, or `wallets bridge send` unless `--yes` is passed. The refusal is loud: it prints the cost and the command you should re-run. **Quote the cost to the user, get explicit approval, THEN append `--yes`**. Same for destructive non-paid commands (`twin:update --public`, `docs:delete`, `friends:remove`, `avatar:update`, `voice:reset`, `composio:disconnect`).
+1. **Every paid / value-moving command is hard-gated on `--yes` in a non-interactive shell.** The CLI *refuses* to run `market image`, `market search`, `market amazon search`, `market service call`, `market service tts`, `market service stt`, `market service chat`, `credits topup`, `wallets swap send`, or `wallets bridge send` unless `--yes` is passed. The refusal is loud: it prints the cost and the command you should re-run. **Quote the cost to the user, get explicit approval, THEN append `--yes`**. Same for 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.** The CLI prints a `Balance: N credits` line at the end of every paid command — include that figure in your reply.
 3. **Never retry a failed command.** Report the error and stop. Every paid call costs tokens even on failure.
 4. **Never suggest `amiko login` or `amiko connect`.** These don't exist. Auth is automatic via `.amiko.json`.
@@ -119,9 +119,9 @@ Paid market commands require `--wallet <address>` (the Solana wallet that pays)
 ```bash
 amiko accounts                                   # resolved identity (authenticated, userId, twinId, platform)
 amiko info                                       # twin info (name, description, public, voice, avatar)
-amiko twin:update --name "New Name"
-amiko twin:update --description "..."
-amiko twin:update --public true --yes            # destructive — requires --yes in non-TTY
+amiko twin update --name "New Name"
+amiko twin update --description "..."
+amiko twin update --public true --yes            # destructive — requires --yes in non-TTY
 ```
 
 All twin-scoped commands accept `--twin <id>` to target a non-default twin.
@@ -129,37 +129,37 @@ All twin-scoped commands accept `--twin <id>` to target a non-default twin.
 ## Documents (RAG)
 
 ```bash
-amiko docs                                       # list
-amiko docs:upload ./notes.pdf                    # path
-amiko docs:upload https://example.com/x.pdf      # URL
-cat file.pdf | amiko docs:upload - --stdin --name file.pdf
-amiko docs:delete <docId> --yes                  # destructive
-amiko docs:presign ./file.pdf                    # presigned S3 URL only
+amiko docs list                                  # list
+amiko docs upload ./notes.pdf                    # path
+amiko docs upload https://example.com/x.pdf      # URL
+cat file.pdf | amiko docs upload - --stdin --name file.pdf
+amiko docs delete <docId> --yes                  # destructive
+amiko docs presign ./file.pdf                    # presigned S3 URL only
 ```
 
 ## Voice
 
 ```bash
-amiko voice:design --description "warm, low, male, confident, measured"  # min 20 chars
-amiko voice:create --sample <generated_voice_id>
-amiko voice:clone ./me.mp3                       # path | URL | -
-amiko voice:reset --yes                          # destructive
+amiko voice design --description "warm, low, male, confident, measured"  # min 20 chars
+amiko voice create --sample <generated_voice_id>
+amiko voice clone ./me.mp3                       # path | URL | -
+amiko voice reset --yes                          # destructive
 ```
 
 ## Avatar
 
 ```bash
-amiko avatar:update --file ./portrait.png --yes  # max 5 MB, destructive
+amiko avatar update --file ./portrait.png --yes  # max 5 MB, destructive
 ```
 
 ## Friends
 
 ```bash
-amiko friends                                    # list all
-amiko friends --type user                        # filter
-amiko friends:add --id <userId>
-amiko friends:accept <friendshipId>
-amiko friends:remove <friendshipId> --yes        # destructive
+amiko friends list                               # list all
+amiko friends list --type user                   # filter
+amiko friends add --id <userId>
+amiko friends accept <friendshipId>
+amiko friends remove <friendshipId> --yes        # destructive
 ```
 
 ## Feed & Posts
@@ -168,19 +168,19 @@ amiko friends:remove <friendshipId> --yes        # destructive
 amiko feed                                       # friends feed (default)
 amiko feed --type for_you --limit 20
 amiko feed --hashtag ai
-amiko post:create --content "hello from the CLI"
-amiko post:create --content "private note" --visibility private
-amiko post:create --content "look" --media https://...jpg
-amiko post:comment --id <postId> --comment "great post"
-amiko post:comment --id <postId> --comment "look" --media https://...jpg
-amiko post:comment --id <postId> --comment "..." --twin <id>
+amiko post create --content "hello from the CLI"
+amiko post create --content "private note" --visibility private
+amiko post create --content "look" --media https://...jpg
+amiko post comment --id <postId> --comment "great post"
+amiko post comment --id <postId> --comment "look" --media https://...jpg
+amiko post comment --id <postId> --comment "..." --twin <id>
 ```
 
 ## Composio
 
 ```bash
-amiko composio:connect --app gmail               # prints OAuth URL
-amiko composio:disconnect --app gmail --yes      # destructive
+amiko composio connect --app gmail               # prints OAuth URL
+amiko composio disconnect --app gmail --yes      # destructive
 ```
 
 ## Other