neodrop-cli 1.1.0 → 1.2.0

package/README.md

@@ -39,14 +39,23 @@ No browser is auto-launched, no local port is opened, no callback is needed —
 
 ## Commands
 
-| Area | Commands |
-|---|---|
-| Identity | `me` · `whoami` · `tokens list` |
-| Channels | `channels list` · `get` · `search` · `create` · `subscribe` · `unsubscribe` · `categories` · `by-category` |
-| Posts | `posts list` · `get` · `search` · `feed` |
-| Raw procedure | `api <procedure> [--json '…' \| --stdin] [--mutation]` |
-
-Full command reference: [`references/commands.md`](https://github.com/NeoDropAI/neodrop-skills/blob/main/skills/neodrop-cli/references/commands.md).
+| Area | What you can do | Commands |
+|---|---|---|
+| **Identity** | Who am I, and manage my access tokens | `me` · `whoami` · `tokens list` · `tokens revoke <id>` |
+| **Channels** | Browse, search, create and subscribe to channels | `channels list` · `get` · `search` · `create` · `subscribe` · `unsubscribe` · `categories` · `by-category` |
+| **Posts** | Read and search content; view your subscribed feed | `posts list` · `get` · `search` · `feed` |
+| **Chat** | Message a Neodrop AI assistant and get the full reply | `chat "<message>" [--session <id> \| --channel <id>]` · `chat history` · `chat sessions` |
+| **Raw procedure** | Call any tRPC procedure with no sugar command | `api <procedure> [--json '…' \| --stdin] [--mutation]` |
+
+Every command takes `--help` for its arguments and `--pretty` for indented JSON. Full reference with per-command tables: [`references/commands.md`](https://github.com/NeoDropAI/neodrop-skills/blob/main/skills/neodrop-cli/references/commands.md).
+
+### Chat, in one line
+
+```bash
+npx neodrop-cli chat "What's new in my subscriptions this week?"
+```
+
+Sends the message, blocks until the assistant's reply is fully generated (server-side, so it survives disconnects), and prints `{sessionId, reply, newMessages}` as JSON. Reuse the printed `sessionId` with `--session` to continue the conversation, or add `--channel <id>` to talk to a specific channel's assistant.
 
 ## Use as an AI-agent skill
 

package/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: neodrop-cli
-version: 1.1.0
+version: 1.2.0
 tested_with:
-  neodrop_api: "2026-06"
+  neodrop_api: "2026-07"
   node: ">=18"
-description: Operate the Neodrop platform (neodrop.ai) as the current user — create channels, subscribe / unsubscribe, search public channels and content, browse categories, list your own channels, and read post details. Trigger this skill whenever the user mentions Neodrop or neodrop.ai, "my channels" / "what am I subscribed to", "post" / "posts" (Neodrop's content units — also called "grain" / "grains", the legacy name), "create a channel" / "subscribe to this channel" / "search channels", public content / public feed / subscribed feed — or the same intent in any language. Always call `npx neodrop-cli <command>`; do NOT use fetch / curl / hand-rolled HTTP — this skill already handles auth, JSON serialization, error codes and locale defaults.
+description: Operate the Neodrop platform (neodrop.ai) as the current user — create channels, subscribe / unsubscribe, search public channels and content, browse categories, list your own channels, read post details, and chat with Neodrop's AI assistants (global or per-channel, sending a message and receiving the full reply). Trigger this skill whenever the user mentions Neodrop or neodrop.ai, "my channels" / "what am I subscribed to", "post" / "posts" (Neodrop's content units — also called "grain" / "grains", the legacy name), "create a channel" / "subscribe to this channel" / "search channels", "ask Neodrop's assistant" / "chat with my channel", public content / public feed / subscribed feed — or the same intent in any language. Always call `npx neodrop-cli <command>`; do NOT use fetch / curl / hand-rolled HTTP — this skill already handles auth, JSON serialization, error codes and locale defaults.
 ---
 
 # neodrop-cli skill
@@ -61,6 +61,7 @@ Full flow + security model + reusing credentials across machines: [`references/a
 | Current user / token | `me` / `whoami` / `tokens list` | [`references/commands.md#identity`](references/commands.md#identity) |
 | View / search / create / subscribe channels | `channels list/get/search/create/subscribe/unsubscribe`, `channels categories`, `channels by-category` | [`references/commands.md#channels`](references/commands.md#channels) |
 | View / search post content | `posts list/get/search`, `feed` | [`references/commands.md#posts`](references/commands.md#posts) |
+| Chat with the AI assistant (send a message, wait for the full reply) | `chat "<message>" [--session <id> \| --channel <id>]`, `chat history`, `chat sessions` | [`references/commands.md#chat`](references/commands.md#chat) |
 | A procedure with no sugar command | `api <procedure> [--json '…' \| --stdin] [--mutation]` | [`references/commands.md#api`](references/commands.md#api) |
 | User pasted a Neodrop URL and wants details | Map URL → id, call the matching `get` command | [`references/url-routing.md`](references/url-routing.md) |
 | Failure / error | Read the error code on stderr | [`references/troubleshooting.md`](references/troubleshooting.md) |

package/bin/neodrop.mjs

@@ -14,6 +14,7 @@
 import { hostname } from "node:os";
 import { parseArgs } from "node:util";
 import { ApiError, trpcMutation, trpcQuery } from "../lib/api.mjs";
+import { resolveChatSession, sendAndAwaitReply } from "../lib/chat.mjs";
 import {
   clearCredentials,
   credentialsPath,
@@ -460,6 +461,83 @@ async function cmdFeed(argv) {
   emit(await trpcQuery({ apiOrigin, token }, "grain.listSubscribed", payload));
 }
 
+// ---- chat 命令 --------------------------------------------------------
+
+async function cmdChatSend(argv) {
+  const { values, positionals } = parse(argv, {
+    session: { type: "string" },
+    channel: { type: "string" },
+    locale: { type: "string", default: "en" },
+    timeout: { type: "string" },
+    "poll-interval": { type: "string" },
+  });
+  const text = requirePositional(
+    positionals,
+    0,
+    '用法：neodrop chat "<message>" [--session <id> | --channel <id>] [--locale en] [--timeout 秒]\n' +
+      "     neodrop chat history --session <id>",
+  );
+  if (values.session && values.channel) {
+    throw new UsageError("--session 与 --channel 互斥：--session 继续既有会话，--channel 拿该频道的助手会话");
+  }
+  const timeoutSec = values.timeout === undefined ? 600 : Number(values.timeout);
+  if (!Number.isFinite(timeoutSec) || timeoutSec <= 0) {
+    throw new UsageError(`--timeout 必须是正数秒，收到「${values.timeout}」`);
+  }
+  const pollSec = values["poll-interval"] === undefined ? 2 : Number(values["poll-interval"]);
+  if (!Number.isFinite(pollSec) || pollSec <= 0) {
+    throw new UsageError(`--poll-interval 必须是正数秒，收到「${values["poll-interval"]}」`);
+  }
+
+  const { apiOrigin, token } = authedCtx();
+  let sessionId = values.session;
+  if (!sessionId) {
+    sessionId = await resolveChatSession({ apiOrigin, token, channelId: values.channel });
+    note(`会话 ${sessionId}（继续对话：neodrop chat "…" --session ${sessionId}）`);
+  }
+
+  const result = await sendAndAwaitReply({
+    apiOrigin,
+    token,
+    sessionId,
+    text,
+    locale: values.locale,
+    timeoutMs: timeoutSec * 1000,
+    pollIntervalMs: pollSec * 1000,
+  });
+  if (!result.reply) {
+    note("⚠ 本轮没有 assistant 文本回复（可能生成失败或被取消），newMessages 里是本轮全部新增消息。");
+  }
+  emit(result);
+}
+
+async function cmdChatHistory(argv) {
+  const { values } = parse(argv, {
+    session: { type: "string" },
+  });
+  if (!values.session) {
+    throw new UsageError("用法：neodrop chat history --session <id>");
+  }
+  const { apiOrigin, token } = authedCtx();
+  emit(
+    await trpcQuery({ apiOrigin, token }, "session.getMessages", {
+      sessionId: values.session,
+    }),
+  );
+}
+
+async function cmdChatSessions() {
+  const { apiOrigin, token } = authedCtx();
+  emit(await trpcQuery({ apiOrigin, token }, "session.list"));
+}
+
+async function cmdChat(argv) {
+  const sub = argv[0];
+  if (sub === "history") return cmdChatHistory(argv.slice(1));
+  if (sub === "sessions") return cmdChatSessions();
+  return cmdChatSend(argv);
+}
+
 // ---- 兜底通道 ---------------------------------------------------------
 
 async function cmdApi(argv) {
@@ -528,6 +606,14 @@ const HELP = `neodrop — Neodrop CLI（AI agent 与人类共用，stdout = JSON
   posts search "<query>" [--limit N] [--locale L] [--strict]
   feed [--limit N] [--cursor C]                        = posts list --subscribed
 
+对话（chat）：
+  chat "<message>" [--session <id> | --channel <id>] [--locale L] [--timeout 秒]
+                                                       发消息给 AI 助手并等完整回复（默认新建全局
+                                                       助手会话；--session 继续对话；--channel 和
+                                                       该频道的助手聊）
+  chat history --session <id>                          查看会话全部消息
+  chat sessions                                        列出我的会话
+
 兜底：
   api <procedure> [--json '...' | --stdin] [--mutation]
 
@@ -602,6 +688,8 @@ async function dispatch(rawArgs) {
       return dispatchGroup("posts", POSTS_SUB, rest);
     case "feed":
       return cmdFeed(rest);
+    case "chat":
+      return cmdChat(rest);
     case "api":
       return cmdApi(rest);
     case "install-skill":

package/lib/chat.mjs

@@ -0,0 +1,170 @@
+// chat 能力：发一条消息给 Neodrop 的对话 agent，等回复生成完，拿完整回复。
+//
+// 链路（全部走用户 PAT，Bearer 鉴权）：
+//   1. 建 / 复用会话：session.create（全局助手）或
+//      session.getOrCreateChannelAssistant（--channel 频道助手）——tRPC mutation
+//   2. 发送：POST /api/chat（非 tRPC 的 Hono 端点，后端 2026-07 起支持 PAT Bearer）。
+//      响应是 SSE 流；回复由后端 BullMQ worker 生成、与本连接生命周期解耦，
+//      CLI 不解析流内容，只把「流读到 EOF」当作大概率完成的信号。
+//   3. 收敛：轮询 session.getActiveChatTurn 直到 null（turn 已 terminal——
+//      SSE 中途断线也靠这层兜住），再 session.getMessages 取本次 user 消息
+//      之后新增的消息作为回复。最终一致以 getMessages 为准，不信任流。
+//
+// 为什么不解析 SSE：UIMessage chunk 协议类型多且随主仓演进，CLI 的消费者是
+// AI agent，要的是「一次拿到完整回复的 JSON」，不是逐 token 渲染。
+
+import { randomUUID } from "node:crypto";
+import { trpcMutation, trpcQuery } from "./api.mjs";
+import { note } from "./output.mjs";
+
+const USER_AGENT = "neodrop-cli/1.0 (+https://github.com/NeoDropAI/neodrop-skills)";
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// POST /api/chat 发送消息。成功返回 Response（SSE 已开始）；HTTP >= 400 时
+// 解析 JSON error 抛出（402 余额不足 / 401 未登录 / 400 消息非法等）。
+async function postChatMessage({ apiOrigin, token, sessionId, text, locale, signal }) {
+  const url = `${apiOrigin.replace(/\/+$/, "")}/api/chat`;
+  const body = {
+    sessionId,
+    locale,
+    message: {
+      id: randomUUID(),
+      role: "user",
+      parts: [{ type: "text", text }],
+    },
+  };
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+      "user-agent": USER_AGENT,
+      authorization: `Bearer ${token}`,
+    },
+    body: JSON.stringify(body),
+    signal,
+  });
+  if (res.status >= 400) {
+    let payload = null;
+    try {
+      payload = await res.json();
+    } catch {
+      // 非 JSON 错误体，用 HTTP 状态兜底
+    }
+    const msg = (payload && (payload.error || payload.message)) || `HTTP ${res.status}`;
+    const code = (payload && payload.code) || "";
+    throw new Error(code ? `[${code}] ${msg}` : `发送失败：${msg}`);
+  }
+  return { response: res, userMessageId: body.message.id };
+}
+
+// 读 SSE 流到 EOF（内容丢弃）。断线 / 超时都不算失败——后端 worker 与连接
+// 解耦，最终状态交给 getActiveChatTurn 轮询收敛。
+async function drainStream(response) {
+  try {
+    if (!response.body) return;
+    for await (const _chunk of response.body) {
+      // 只等 EOF，不解析
+    }
+  } catch {
+    note("⚠ SSE 连接中断，转轮询等待回复…");
+  }
+}
+
+// 轮询直到 session 没有 live 的 chat turn（回复已生成完 / 失败 / 取消）。
+async function pollUntilTurnSettled({ apiOrigin, token, sessionId, deadline, intervalMs }) {
+  for (;;) {
+    const turn = await trpcQuery({ apiOrigin, token }, "session.getActiveChatTurn", {
+      sessionId,
+    });
+    if (!turn) return;
+    if (Date.now() > deadline) {
+      throw new Error(
+        `等待回复超时（turn=${turn.id} 仍在 ${turn.status}）。稍后可用 chat history --session ${sessionId} 查看结果。`,
+      );
+    }
+    await sleep(intervalMs);
+  }
+}
+
+function extractText(parts) {
+  if (!Array.isArray(parts)) return "";
+  return parts
+    .filter((p) => p && p.type === "text" && typeof p.text === "string")
+    .map((p) => p.text)
+    .join("");
+}
+
+/**
+ * 发送一条消息并等待完整回复。
+ *
+ * @returns {Promise<{sessionId: string, reply: {text: string, parts: unknown[]} | null, newMessages: unknown[]}>}
+ *   reply 是本次新增消息里最后一条 assistant 消息（text = 其 text parts 拼接）；
+ *   turn 失败等场景下可能没有 assistant 回复，reply 为 null，调用方看 newMessages 自行判断。
+ */
+export async function sendAndAwaitReply({
+  apiOrigin,
+  token,
+  sessionId,
+  text,
+  locale,
+  timeoutMs,
+  pollIntervalMs,
+}) {
+  const deadline = Date.now() + timeoutMs;
+  const abort = AbortSignal.timeout(timeoutMs);
+
+  note(`→ 发送到 session ${sessionId} …`);
+  const { response, userMessageId } = await postChatMessage({
+    apiOrigin,
+    token,
+    sessionId,
+    text,
+    locale,
+    signal: abort,
+  });
+
+  note("… 回复生成中");
+  await drainStream(response);
+  await pollUntilTurnSettled({
+    apiOrigin,
+    token,
+    sessionId,
+    deadline,
+    intervalMs: pollIntervalMs,
+  });
+
+  const messages = await trpcQuery({ apiOrigin, token }, "session.getMessages", {
+    sessionId,
+  });
+  // 本次 user 消息之后新增的所有消息 = 这轮回复（含 tool / data 卡片等中间产物）
+  const anchor = messages.findIndex((m) => m.id === userMessageId);
+  const newMessages = anchor >= 0 ? messages.slice(anchor + 1) : [];
+  const lastAssistant = [...newMessages]
+    .reverse()
+    .find((m) => m.role === "assistant");
+
+  return {
+    sessionId,
+    reply: lastAssistant
+      ? { text: extractText(lastAssistant.parts), parts: lastAssistant.parts }
+      : null,
+    newMessages,
+  };
+}
+
+/** 建新会话（全局助手），或按 --channel 拿该频道的助手会话。 */
+export async function resolveChatSession({ apiOrigin, token, channelId }) {
+  if (channelId) {
+    const session = await trpcMutation(
+      { apiOrigin, token },
+      "session.getOrCreateChannelAssistant",
+      { channelId },
+    );
+    return session.id;
+  }
+  const session = await trpcMutation({ apiOrigin, token }, "session.create", {});
+  return session.id;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "neodrop-cli",
-  "version": "1.1.0",
-  "description": "Neodrop (neodrop.ai) CLI — let your AI agent (Claude Code / Cursor / Codex) browse channels, read posts, manage subscriptions and create channels as you. stdout is always valid JSON. npx neodrop-cli login and go.",
+  "version": "1.2.0",
+  "description": "Neodrop (neodrop.ai) CLI — let your AI agent (Claude Code / Cursor / Codex) browse channels, read posts, manage subscriptions, create channels and chat with Neodrop's AI assistants as you. stdout is always valid JSON. npx neodrop-cli login and go.",
   "type": "module",
   "bin": {
     "neodrop": "bin/neodrop.mjs"

package/references/commands.md

@@ -1,74 +1,98 @@
 # neodrop-cli command reference
 
-> Invocation convention: use `npx neodrop-cli <command>` (see [SKILL.md → How to invoke](../SKILL.md#how-to-invoke)).
-> Equivalent explicit package + bin form: `npx -p neodrop-cli neodrop <command>`.
-> Examples below are written as `neodrop <command>`.
+> Invocation convention: `npx neodrop-cli <command>` (see [SKILL.md → How to invoke](../SKILL.md#how-to-invoke)).
+> Equivalent explicit form: `npx -p neodrop-cli neodrop <command>`. Examples below are written as `neodrop <command>`.
+>
+> Every command prints **valid JSON to stdout**; logs, progress and `🔗` links go to stderr. Add `--pretty` for indented JSON, `--help` on any command for its arguments.
 
 ## identity
 
-```bash
-neodrop me                    # current user info (user.getMe)
-neodrop whoami                # me + token metadata (credential + expiry)
-neodrop tokens list           # every PAT you've issued
-neodrop tokens revoke <id>    # revoke a PAT; if it's this machine's token, the local credential is cleared too
-```
+| Command | What it does |
+|---|---|
+| `neodrop me` | Current user info (`user.getMe`). |
+| `neodrop whoami` | `me` plus token metadata — which credential is in use and when it expires. |
+| `neodrop tokens list` | Every Personal Access Token you've issued. |
+| `neodrop tokens revoke <id>` | Revoke a PAT. If it's this machine's token, the local credential is cleared too. |
 
 ## channels
 
-### View / search
+**View & search**
 
-```bash
-neodrop channels list --mine                       # channels you own
-neodrop channels list --locale en --limit 20       # public channels, paginated
-neodrop channels get <channelId>                   # single channel detail (incl. requirement.public)
-neodrop channels categories                        # all categories
-neodrop channels by-category tech --sort latest --limit 20
+| Command | What it does |
+|---|---|
+| `neodrop channels list --mine` | Channels you own. |
+| `neodrop channels list --locale en --limit 20` | Public channels, paginated. |
+| `neodrop channels get <channelId>` | Single channel detail, including `requirement.public`. |
+| `neodrop channels categories` | All channel categories. |
+| `neodrop channels by-category <category> --sort latest --limit 20` | Channels in a category. |
+| `neodrop channels search "<query>" --locale en --limit 10` | Full-text search over the public pool. |
 
-neodrop channels search "AI weekly" --locale en --limit 10
-```
+**Create & subscribe**
 
-### Write
+| Command | What it does |
+|---|---|
+| `neodrop channels create --name "<name>" --description "<desc>" --locale en` | Create a channel from flags. |
+| `neodrop channels create --json '{"name":"X","locale":"en","type":"PRIVATE"}'` | Create a channel from a full JSON payload. |
+| `neodrop channels subscribe <channelId>` | Subscribe to a channel. |
+| `neodrop channels unsubscribe <channelId>` | Unsubscribe from a channel. |
 
-```bash
-neodrop channels create --name "AI industry tracker" --description "..." --locale en
-neodrop channels create --json '{"name":"X","locale":"en","type":"PRIVATE"}'
-neodrop channels subscribe <channelId>
-neodrop channels unsubscribe <channelId>
-```
-
-**Default locale**: `channels list` defaults to `en`, matching the product's default public pool. `channels search` and `channels by-category` omit locale when `--locale` is not provided and let the backend decide. Pass `--locale en` (etc.) explicitly to query the public pool across locales.
+> **Locale defaults**: `channels list` defaults to `en` (the product's default public pool). `channels search` / `by-category` omit locale unless you pass `--locale`, letting the backend decide. Pass `--locale en` (etc.) explicitly to query across locales.
 
 ## posts
 
-> The content unit is called a **post** on Neodrop. The old command name `grains` is kept as a backward-compatible alias, but new code should use `posts`.
+> The content unit is a **post**. The old name `grains` stays as a backward-compatible alias; new code should use `posts`.
+
+| Command | What it does |
+|---|---|
+| `neodrop posts list --limit 10` | Public feed. |
+| `neodrop posts list --subscribed --limit 10` | Posts from your subscriptions (same as `neodrop feed --limit 10`). |
+| `neodrop posts list --channel <channelId> --limit 10` | Posts from one channel. |
+| `neodrop posts get <postId>` | Single post detail. |
+| `neodrop posts search "<query>" --limit 10` | Full-text search over posts. |
+| `neodrop feed --limit 10` | Alias for `posts list --subscribed`. |
+
+## chat
+
+Talk to Neodrop's AI assistants as the current user. The command **blocks until the reply is fully generated** (replies come from a backend worker and survive disconnects), then prints the complete result as JSON.
+
+| Command | What it does |
+|---|---|
+| `neodrop chat "<message>"` | Send a message to the **global assistant** in a new session. |
+| `neodrop chat "<message>" --session <sessionId>` | Continue an existing session. |
+| `neodrop chat "<message>" --channel <channelId>` | Talk to a **channel assistant** (owner: can edit the channel's config; reader: Q&A about the channel). |
+| `neodrop chat history --session <sessionId>` | Full message list of a session. |
+| `neodrop chat sessions` | Your sessions — find one to continue. |
+
+**Flags**
+
+| Flag | Default | Purpose |
+|---|---|---|
+| `--session <id>` | — | Continue a specific session instead of starting a new one. |
+| `--channel <id>` | — | Target a channel assistant instead of the global assistant. |
+| `--locale <code>` | `en` | Language of the assistant's error messages. |
+| `--timeout <seconds>` | `600` | Max total wait. On timeout the reply keeps generating server-side — fetch it later with `chat history`. |
 
-```bash
-neodrop posts list --limit 10                     # public feed
-neodrop posts list --subscribed --limit 10        # your subscriptions (= neodrop feed --limit 10)
-neodrop posts list --channel <channelId> --limit 10
-neodrop posts get <postId>
-neodrop posts search "Apple Intelligence" --limit 10
+**Output shape**: `{sessionId, reply: {text, parts} | null, newMessages: [...]}` — `reply.text` is the assistant's final text; `newMessages` is every message produced this turn (tool calls, cards, …). `reply` can be `null` if generation failed; inspect `newMessages` then.
 
-neodrop feed --limit 10                            # alias for posts list --subscribed
-```
+- A new conversation prints its `sessionId` on stderr — **reuse it with `--session` for follow-ups**, don't start a fresh session per question.
+- Chat consumes the account's AI credits like the web app does; a `402 insufficient_credits` error means the user must top up.
 
 ## api
 
 For tRPC procedures with no sugar command, fall back to `api`:
 
-```bash
-neodrop api channel.update --json '{"id":"<chId>","name":"New name"}' --mutation
-neodrop api user.getLinkedAccounts                 # any query
-echo '{...}' | neodrop api channel.create --stdin --mutation
-```
+| Command | What it does |
+|---|---|
+| `neodrop api <procedure>` | Call any tRPC **query** (GET). |
+| `neodrop api <procedure> --json '{...}' --mutation` | Call a **write** — `--mutation` is required or the backend rejects it as a query. |
+| `echo '{...}' \| neodrop api <procedure> --stdin --mutation` | Read the JSON input from stdin (great for heredocs / pipelines). |
 
-- **Defaults to a GET query** — a mutation (write) MUST add `--mutation` explicitly, or the backend routes it as a query and rejects it.
-- Pass complex input with `--json '...'` inline, or `--stdin` to read from standard input (great for heredocs / pipelines).
-- To find a procedure's full name, check the main repo's `packages/backend/src/api/trpc/routers.ts`, or probe with `curl /api/trpc/<router>.<procedure>?input=...` against a dev backend.
+- **Defaults to a GET query** — every write MUST add `--mutation` explicitly.
+- To find a procedure's full name, check the main repo's `packages/backend/src/api/trpc/routers.ts`, or probe `curl /api/trpc/<router>.<procedure>?input=...` against a dev backend.
 
-## Global
+## Global flags
 
-```bash
-neodrop --pretty <cmd>          # indented JSON for humans (still valid JSON)
-neodrop <cmd> --help            # subcommand arguments
-```
+| Flag | Purpose |
+|---|---|
+| `--pretty` | Indented JSON for humans (still valid JSON). |
+| `--help` | Show a subcommand's arguments. |