botschat 0.1.21 → 0.1.22

package/README.md

@@ -5,6 +5,7 @@
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
 [![macOS](https://img.shields.io/badge/Download-macOS_App-black?logo=apple&logoColor=white)](https://github.com/botschat-app/botsChat/releases/latest/download/BotsChat-mac.dmg)
 [![iOS](https://img.shields.io/badge/Download-iOS_App-blue?logo=apple&logoColor=white)](https://apps.apple.com/app/botschat-chat-with-agent/id6759292058)
+[![Android](https://img.shields.io/badge/Download-Android_App-green?logo=android&logoColor=white)](https://play.google.com/store/apps/details?id=app.botschat.console)
 
 A self-hosted, **end-to-end encrypted** chat interface for [OpenClaw](https://github.com/openclaw/openclaw) AI agents.
 
@@ -105,7 +106,7 @@ BotsChat is **100% open source** — the [same code](https://github.com/botschat
 | **B. Run Locally** | Development, no cloud account | Yes |
 | **C. Deploy to Cloudflare** | Remote access (e.g. from phone) | Yes |
 
-> **Native Apps**: A macOS client is available — [download the latest DMG](https://github.com/botschat-app/botsChat/releases/latest/download/BotsChat-mac.dmg) (signed and notarized, Apple Silicon + Intel). An iOS app is also available on the [App Store](https://apps.apple.com/app/botschat-chat-with-agent/id6759292058).
+> **Native Apps**: A macOS client is available — [download the latest DMG](https://github.com/botschat-app/botsChat/releases/latest/download/BotsChat-mac.dmg) (signed and notarized, Apple Silicon + Intel). An iOS app is available on the [App Store](https://apps.apple.com/app/botschat-chat-with-agent/id6759292058). An Android app is available on [Google Play](https://play.google.com/store/apps/details?id=app.botschat.console).
 
 Pick one below and follow its steps, then continue to [Install the OpenClaw Plugin](#install-the-openclaw-plugin).
 
@@ -252,6 +253,72 @@ Open the BotsChat web UI in your browser, sign in, and start chatting with your
 4. Your API keys, agent configs, and data never leave your machine — only chat messages travel through the relay.
 5. With **E2E encryption** enabled, messages are encrypted **before** step 3 and decrypted **after** — the ConnectionDO and database only ever see ciphertext.
 
+## CLI
+
+BotsChat includes a command-line client with full E2E encryption support. No install needed — use `npx`:
+
+```bash
+npx @botschat/botschat login              # Login via browser (Google/GitHub/Apple)
+npx @botschat/botschat chat "Hello"       # Send a message
+npx @botschat/botschat chat -i            # Interactive chat
+```
+
+Or install globally for shorter commands:
+
+```bash
+npm i -g @botschat/botschat
+botschat login
+botschat chat "Hello"
+```
+
+### Login
+
+```bash
+npx @botschat/botschat login                          # Browser OAuth (recommended)
+npx @botschat/botschat --url http://localhost:8787 login --dev --secret <secret>  # Local dev
+```
+
+Running `login` opens your browser, you sign in normally, and credentials are saved to `~/.botschat/config.json`.
+
+### Chat
+
+```bash
+npx @botschat/botschat chat "What can you do?"           # Single-shot
+npx @botschat/botschat chat -i                           # Interactive REPL
+echo "Summarize this log" | npx @botschat/botschat chat --pipe  # Pipe from stdin
+npx @botschat/botschat --json chat "Hello"               # JSON output
+```
+
+### Management
+
+```bash
+npx @botschat/botschat whoami                            # Current user info
+npx @botschat/botschat channels                          # List channels
+npx @botschat/botschat sessions <channelId>              # List sessions
+npx @botschat/botschat models                            # List available models
+npx @botschat/botschat models set <modelId>              # Set default model
+npx @botschat/botschat tasks                             # List background tasks
+npx @botschat/botschat tasks run <channelId> <taskId>    # Run a task now
+npx @botschat/botschat jobs <taskId>                     # Job execution history
+npx @botschat/botschat messages <sessionKey>             # Message history
+npx @botschat/botschat tokens                            # Manage pairing tokens
+npx @botschat/botschat status                            # OpenClaw connection status
+npx @botschat/botschat config                            # View config
+npx @botschat/botschat config e2e --password <pwd>       # Set E2E encryption password
+```
+
+### OpenClaw Skill
+
+Use the CLI as an [OpenClaw skill](https://openclawai.com/docs/skills) — your agent can interact with BotsChat directly:
+
+```bash
+npx skills add @botschat/botschat
+```
+
+This registers `/botschat` as a skill in OpenClaw, providing commands like `botschat chat`, `botschat channels`, `botschat status`, etc.
+
+---
+
 ## Plugin Reference
 
 ### Configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botschat",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "A self-hosted chat interface for OpenClaw AI agents",
   "workspaces": [
     "packages/*"

package/packages/plugin/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@botschat/botschat",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "BotsChat channel plugin for OpenClaw — connects your OpenClaw agent to the BotsChat cloud platform",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "botschat-setup": "./bin/botschat-setup.mjs"
+    "botschat-setup": "./bin/botschat-setup.mjs",
+    "botschat": "./bin/botschat-cli.mjs"
   },
   "openclaw": {
     "extensions": [
@@ -37,7 +38,8 @@
   "files": [
     "dist/",
     "bin/",
-    "openclaw.plugin.json"
+    "openclaw.plugin.json",
+    "SKILL.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -46,6 +48,7 @@
     "openclaw": "*"
   },
   "dependencies": {
+    "commander": "^12",
     "ws": "^8.18.0"
   },
   "devDependencies": {