@heyamiko/amiko-cli 0.9.6-beta.2 → 0.9.6-beta.4

package/dist/index.js

@@ -21945,6 +21945,73 @@ function registerConversationCommand(program2) {
   });
 }
 
+// src/commands/notifications.ts
+function registerNotificationsCommand(program2) {
+  program2.command("list").description("List platform notifications (friend requests, system alerts, activity)").option("--limit <n>", "Max results (1–100)", "20").option("--cursor <iso>", "Page older items via next_cursor from a prior call").option("--unread", "Show only unread").option("--json", "Output as JSON").action(async (opts) => {
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Loading notifications...").start();
+    try {
+      const data = await amikoWebFetch(auth, "/api/notifications", {
+        query: { limit: opts.limit, cursor: opts.cursor }
+      });
+      spinner?.stop();
+      const items = opts.unread ? data.notifications.filter((n) => !n.read) : data.notifications;
+      renderOutput({ ...data, notifications: items }, (d) => {
+        if (!items.length) {
+          console.log(dim(opts.unread ? "No unread notifications." : "No notifications."));
+          return;
+        }
+        const headerSuffix = d.unread_count !== undefined ? ` — ${d.unread_count} unread` : "";
+        console.log(heading(`Notifications — ${items.length}${headerSuffix}`));
+        for (const n of items) {
+          console.log("");
+          console.log(label("ID", n.id));
+          console.log(label("Type", n.type));
+          if (n.title)
+            console.log(label("Title", n.title));
+          if (n.message)
+            console.log(n.message);
+          console.log(label("Created", n.created_at.slice(0, 19)));
+          if (!n.read)
+            console.log(dim("• unread"));
+        }
+        if (d.has_more && d.next_cursor) {
+          console.log("");
+          console.log(dim(`Older available — pass --cursor ${d.next_cursor}`));
+        }
+      }, { json: opts.json });
+    } catch (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      process.exit(1);
+    }
+  });
+  program2.command("read").description("Mark a notification as read (or --all for everything)").option("--id <notificationId>", "Notification id to mark read").option("--all", "Mark all notifications as read").option("--json", "Output as JSON").action(async (opts) => {
+    if (!opts.id && !opts.all) {
+      console.error(error("Pass --id <notificationId> or --all"));
+      process.exit(1);
+    }
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Marking read...").start();
+    try {
+      const data = await amikoWebFetch(auth, "/api/notifications", {
+        method: "PATCH",
+        body: opts.all ? { markAllAsRead: true } : { notificationId: opts.id }
+      });
+      spinner?.stop();
+      if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+      }
+      console.log(success(data.message));
+    } catch (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      process.exit(1);
+    }
+  });
+}
+
 // src/commands/wallets.ts
 function formatBalance(b) {
   const n = Number(b.amount) / 10 ** b.decimals;
@@ -22160,6 +22227,7 @@ var post = program2.command("post").description("Create posts and comments on th
 var review = program2.command("review").description("Review queue — list, approve, or reject twin-drafted comments");
 var composio = program2.command("composio").description("Manage Composio app connections");
 var conversation = program2.command("conversation").description("Conversations — list, find, create, send messages between users/agents");
+var notifications = program2.command("notifications").description("Platform notifications — list, mark as read");
 registerCreditsCommand(program2);
 registerSearchCommand(markets);
 registerImageCommand(markets);
@@ -22186,4 +22254,5 @@ registerPostCommand(post);
 registerReviewCommand(review);
 registerComposioCommand(composio);
 registerConversationCommand(conversation);
+registerNotificationsCommand(notifications);
 program2.parse();

package/package.json

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

package/skills/SKILL.md

@@ -33,6 +33,7 @@ Each row is a first-level command group or command. Start here when the user ask
 | `amiko feed` | Read the friends feed, for-you feed, or filter by hashtag |
 | `amiko composio <cmd>` | Connect / disconnect third-party OAuth apps (Gmail, GitHub, …) |
 | `amiko conversation <cmd>` | DM/chat — list, find, create, send messages |
+| `amiko notifications <cmd>` | Platform notifications — list, mark as read |
 | `amiko accounts` | Show the resolved identity (authenticated, userId, twinId, platform) |
 | `amiko info` | Show the active twin (name, description, public, voice, avatar) |
 | `amiko config <cmd>` | Show resolved config |
@@ -281,6 +282,18 @@ amiko conversation send --id <id> --message "agent reply" --as-agent  # send as
 - `send` posts to amiko-web's `POST /api/conversations/<id>/messages` with the Clawd twin token. The server persists the message and fans it out to other participants via the WebSocket broadcast.
 - `--user-id` expects the **internal** user id (the one returned by `amiko users search`), not a Privy DID or handle.
 
+## Notifications
+
+```bash
+amiko notifications list                              # recent platform notifications (default 20)
+amiko notifications list --unread                     # only unread
+amiko notifications list --cursor <iso>               # page older items
+amiko notifications read --id <notificationId>        # mark one read
+amiko notifications read --all                        # mark all read
+```
+
+Platform notifications cover friend requests, mentions, system alerts, and other activity that doesn't belong to any conversation. Use this when the user asks "any notifications?" or "what's new on the platform?". Notifications belonging to a conversation (new DM, comment on your post) still show up here when the platform writes one — they don't replace `conversation read` for actual chat content.
+
 ## Composio
 
 ```bash