@heyamiko/amiko-cli 0.14.0-beta.19 → 0.14.0-beta.20

package/README.md

@@ -509,7 +509,7 @@ src/
 │   ├── avatar.ts         # avatar update
 │   ├── friends.ts        # friends list, requests, add, accept, remove, matches, reports
 │   ├── users.ts          # users search, profile
-│   └── feed.ts           # feed, post create, post comment
+│   └── feed.ts           # feed, post create/drafts/publish, post comment
 └── lib/
     ├── config.ts          # defaults + resolved auth wrapper
     ├── agent-config.ts    # .amiko.json reader + auth resolution
@@ -570,6 +570,9 @@ amiko feed --type for_you --limit 20
 amiko post create --content "hello from the CLI"           # public post — prints the canonical share URL (post_url in --json); share that verbatim, never hand-build one from the id
 amiko post create --content "private note" --visibility private
 amiko post create --content "look" --media https://...jpg
+amiko post create --content "wip idea" --draft         # save a draft — no share URL until published
+amiko post drafts                                       # list draft posts (--limit/--offset/--json)
+amiko post publish <postId>                             # publish a draft (fresh timestamp, prints the share URL)
 amiko post comment --id <postId> --comment "great post"
 amiko post comment --id <postId> --comment "nice!" --media https://...jpg
 ```
@@ -594,6 +597,10 @@ npm publish
 
 ## Changelog
 
+### 0.14.0-beta.20
+
+- **Draft posts: `amiko post create --draft`, `amiko post drafts`, `amiko post publish <postId>`.** `--draft` saves via `POST /api/posts { status: "draft" }` — no side effects fire and no share URL is printed (drafts 404 by id until published; success copy says "Draft saved" with a publish hint, and `post_url` is omitted from `--json`). `drafts` lists the owner's draft posts (`GET /api/posts?status=draft`, offset pagination via `--limit`/`--offset`; owner-wide across all the owner's twins). `publish` PATCHes `{ status: "published" }`, stamps a fresh timestamp, fires mention/hashtag notifications, and prints the canonical share URL; a 404 points at `amiko post drafts` since drafts can't be fetched by id. Requires the amiko-web draft-posts API (`feat/draft-posts`).
+
 ### 0.14.0-beta.19
 
 - **Pinned messages: `amiko chat pin <messageId>`, `amiko chat unpin <messageId>`, `amiko chat pinned <target>`.** Pins are conversation-wide: `pin` posts an "X pinned a message" announcement to the whole chat (POST `/api/messages/{id}/pin`), so it sits behind the outward-action `--yes` gate with a content preview; `unpin` (DELETE, silent but removes shared state for everyone) sits behind the destructive gate. Groups are admin-gated server-side — a 403 names the rule and the `chat group info` check; DMs let either side pin. 409 at the 20-pin cap and 400 for unpinnable (system/in-flight) messages get status-specific copy. `pinned <target>` is an ungated read using the same target resolution as `chat read` (conversation id, user id, `@handle`, or name; never creates a DM), listing pins oldest-first with sender, message id, and pinner name; `--raw` on all three. Requires the companion amiko-web `feat/chat-pinned-messages` deploy.

package/dist/index.js

@@ -30739,35 +30739,92 @@ function registerFeedCommand(program2) {
   });
 }
 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 <pathOrUrl...>", "Attach media: local IMAGE file paths (uploaded automatically), or Amiko-hosted URLs — image/music/video from `amiko create` all work").option("--json", "Output as JSON").action(async (opts) => {
+  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 <pathOrUrl...>", "Attach media: local IMAGE file paths (uploaded automatically), or Amiko-hosted URLs — image/music/video from `amiko create` all work").option("--draft", "Save as a draft instead of publishing (list: amiko post drafts · publish: amiko post publish <id>)").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();
+    const workingText = opts.draft ? "Saving draft..." : "Publishing post...";
+    const spinner = opts.json ? null : ora(workingText).start();
     try {
       const body = {
         content: opts.content,
         visibility
       };
+      if (opts.draft)
+        body.status = "draft";
       if (opts.media?.length) {
         if (spinner)
           spinner.text = "Uploading media...";
         body.media_urls = await resolveMediaUrls(auth, opts.media);
         if (spinner)
-          spinner.text = "Publishing post...";
+          spinner.text = workingText;
       }
       const data = await amikoWebFetch(auth, "/api/posts", { method: "POST", body });
       spinner?.stop();
-      const postUrl = data.post?.id ? `https://platform.heyamiko.com/post/${data.post.id}` : null;
+      const postUrl = !opts.draft && data.post?.id ? `https://platform.heyamiko.com/post/${data.post.id}` : null;
       renderOutput(postUrl ? { ...data, post_url: postUrl } : data, (d) => {
-        console.log(success("Post published"));
+        console.log(success(opts.draft ? "Draft saved" : "Post published"));
         const post = d.post;
         if (post) {
           if (post.id)
             console.log(label("Post ID", String(post.id)));
           if (postUrl)
             console.log(label("URL", postUrl));
+          if (opts.draft)
+            console.log(label("Status", "draft"));
           console.log(label("Visibility", visibility));
+          if (opts.draft && post.id) {
+            console.log(dim(`No public URL until published. List: amiko post drafts · Publish: amiko post publish ${post.id}`));
+          }
+        }
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      process.exit(1);
+    }
+  });
+  program2.command("drafts").description("List your draft posts (newest first)").option("--limit <n>", "Max results (1-100, default 20)", "20").option("--offset <n>", "Pagination offset", "0").option("--json", "Output as JSON").action(async (opts) => {
+    const limit = Number(opts.limit ?? "20");
+    const offset = Number(opts.offset ?? "0");
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+      console.error(error("--limit must be an integer between 1 and 100"));
+      process.exit(1);
+    }
+    if (!Number.isInteger(offset) || offset < 0) {
+      console.error(error("--offset must be a non-negative integer"));
+      process.exit(1);
+    }
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Loading drafts...").start();
+    try {
+      const data = await amikoWebFetch(auth, "/api/posts", {
+        query: {
+          status: "draft",
+          limit,
+          offset
+        }
+      });
+      spinner?.stop();
+      const posts = data.posts ?? [];
+      renderOutput(data, () => {
+        if (posts.length === 0) {
+          console.log(dim('No drafts. Save one with: amiko post create --content "..." --draft'));
+          return;
         }
+        console.log(heading(`Drafts — ${posts.length}`));
+        for (const p of posts) {
+          console.log("");
+          console.log(label(p.twin?.name ?? "you", (p.updated_at ?? p.created_at)?.slice(0, 16) ?? ""));
+          console.log(p.content.length > 120 ? `${p.content.slice(0, 120)}…` : p.content);
+          const mediaCount = p.media_urls?.length ?? 0;
+          console.log(dim(`${p.visibility ?? "public"}${mediaCount ? ` · ${mediaCount} media` : ""}`));
+          console.log(dim(`id: ${p.id}`));
+        }
+        console.log("");
+        if (data.hasMore) {
+          console.log(dim(`More available — pass --offset ${offset + posts.length}`));
+        }
+        console.log(dim("Publish: amiko post publish <id>"));
       }, { json: opts.json });
     } catch (e5) {
       spinner?.stop();
@@ -30775,6 +30832,34 @@ function registerPostCommand(program2) {
       process.exit(1);
     }
   });
+  program2.command("publish <postId>").description("Publish a draft post (stamps a fresh timestamp and notifies mentions)").option("--json", "Output as JSON").action(async (postId, opts) => {
+    const auth = resolveAuth();
+    const spinner = opts.json ? null : ora("Publishing draft...").start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/posts/${encodeURIComponent(postId)}`, {
+        method: "PATCH",
+        body: { status: "published" }
+      });
+      spinner?.stop();
+      const postUrl = data.post?.id ? `https://platform.heyamiko.com/post/${data.post.id}` : null;
+      renderOutput(postUrl ? { ...data, post_url: postUrl } : data, (d) => {
+        console.log(success("Post published"));
+        const post = d.post;
+        if (post?.id)
+          console.log(label("Post ID", String(post.id)));
+        if (postUrl)
+          console.log(label("URL", postUrl));
+      }, { json: opts.json });
+    } catch (e5) {
+      spinner?.stop();
+      if (e5.status === 404) {
+        console.error(error(`Post ${postId} not found (or not yours). Find draft ids via: amiko post drafts`));
+      } else {
+        console.error(error(e5 instanceof Error ? e5.message : String(e5)));
+      }
+      process.exit(1);
+    }
+  });
   program2.command("comments").description("List comments on a post").requiredOption("--id <postId>", "Target post id").option("--limit <n>", "Max results (default 20, max 100)").option("--cursor <id>", "Pagination cursor").option("--replies", "Include nested replies (default: top-level only)").option("--json", "Output as JSON").action(async (opts) => {
     const auth = resolveAuth();
     const spinner = opts.json ? null : ora("Loading comments...").start();

package/package.json

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

package/skills/SKILL.md

@@ -31,6 +31,8 @@ Call your shell tool (your runtime calls it `bash`, `shell`, `run`, or similar)
 | "download the file with id X" | shell → `amiko drive download X` |
 | "find files about Q1 revenue" | shell → `amiko drive search "Q1 revenue"` |
 | "what comments are on my post?" | shell → `amiko post comments --id <postId>` |
+| "save this as a post draft, don't publish yet" | shell → `amiko post create --content "…" --draft` |
+| "publish that draft" | shell → `amiko post drafts` (copy the id) → `amiko post publish <postId>` |
 | "search memory for X" | shell → `amiko memory search "X"` |
 | "share the group's invite link" (asked by an admin) | shell → `amiko chat group info "<group>"` (confirm they're admin) → `amiko chat group invite "<group>"` |
 | "react to the latest message from Ava about the team with a heart" | shell → `amiko chat read "Ava"` (find that message, copy its `id`) → `amiko chat react <messageId> ❤️ --yes` |
@@ -211,6 +213,8 @@ Workflow: start with `friends matches --limit 20 --json`; narrow with `--dimensi
 
 **Sharing a post link: copy the printed URL verbatim.** `amiko post create` prints the post's canonical `URL` (`https://platform.heyamiko.com/post/<id>`; also `post_url` in `--json`). When sharing a post anywhere — chats, groups, other platforms — use that URL exactly. **Never compose a post URL yourself from the id**: guessed domains (e.g. `amiko.ai`) are not Amiko and send readers to a parked page.
 
+**Draft posts vs the review queue — two different "drafts."** `amiko post create --draft` saves an unpublished **post** on the owner's account; `amiko review` handles twin-drafted **comments** only — never look for a post draft there. Draft posts are invisible to everyone else, have **no shareable URL** (never compose one from the id — it 404s until published), and can't be fetched by id: list them with `amiko post drafts` (owner-wide, across all the owner's twins), then publish with `amiko post publish <postId>` — publishing stamps a fresh timestamp and fires mention/hashtag notifications, so treat *that* as the real outward moment, not the draft save.
+
 **Comments authored by a twin always go through review.** Any comment created with `amiko post comment ... --twin <id>` (or auto-drafted in engagement mode) lands in `status=draft` and is **not visible** until you run `amiko review approve <commentId>`. Comments without `--twin` (the owner posting) publish immediately. Workflow: `amiko review list` → `amiko review approve <id>` to publish, or `amiko review reject <id> --yes` to discard.
 
 ## Notifications