neodrop-cli 1.1.0 → 2.0.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 (async) and subscribe to channels | `channels list` · `get` · `search` · `create` · `create-status` · `run` · `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: 2.0.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
@@ -59,14 +59,16 @@ Full flow + security model + reusing credentials across machines: [`references/a
 | Scenario | Command | Details |
 |---|---|---|
 | 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 / create / subscribe channels | `channels list/get/search/create/create-status/run/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) |
 
 ## Hard rules for the AI
 
+- **Channel creation is async and costs credits**: `channels create` starts the creation agent (same pipeline as the web wizard) and usually takes a few minutes. Tell the user creation has started, then poll `channels create-status <taskId>` (or use `--wait`). Don't report "channel created" until the task status is `COMPLETED`.
 - **De-dupe before creating a channel**: run `channels list --mine` to check you don't already own one on the topic, then `channels search` against the public pool for a same-name channel — avoid duplicates.
 - **`channels get <id>` before subscribing** to check locale / private / topic — don't subscribe blindly.
 - **Never hand-craft links from memory** — `posts get` / `channels get` / `me` already print `🔗 <canonical-url>` to stderr; use that line.