@aliwey/bmo 2.0.0 → 2.0.2

package/README.md

@@ -1,90 +1,67 @@
-# BMO — OpenCode AI Coding Assistant
+# BMO
 
-BMO is a unified, self-contained AI coding assistant with Telegram, CLI, and Webchat interfaces. It connects to a local [OpenCode](https://github.com/opencode-ai/opencode) instance and extends it with persistent memory, tool access, custom agents, and a decentralized peer-to-peer Agent Discovery Protocol (BFP).
+BMO connects your local OpenCode instance to Telegram, an interactive terminal TUI, and a webchat interface, all sharing a single SQLite database and session history. 
 
----
+It handles its own dependencies out of the box, packaging a minimal embedded Python runtime, pip dependencies, and cloudflared for secure tunneling.
 
-## 🚀 Installation & Setup
+## Installation
 
-BMO is published as a global Node/npm command-line tool. The installer automatically downloads a minimal embedded Python environment, installs python dependencies, and sets up everything required.
+Install BMO globally via npm:
 
-### 1. Install Globally via npm
 ```bash
 npm install -g @aliwey/bmo
 ```
 
-### 2. Run the Configuration Wizard
-Configure your Telegram Bot Father token, admin Telegram user ID, model settings, and peer registry:
+## Setup
+
+Run the configuration wizard to link your Telegram bot token and define your settings:
+
 ```bash
 bmo init
 ```
-This generates your configuration file at `~/.bmo/.env`.
 
----
+This creates a configuration file in `~/.bmo/.env`.
 
-## ⚡ Quick Start
+## Quick Start
 
-### 🤖 Start the Bot & CLI
-To launch the Telegram bot polling and the interactive terminal TUI:
+### Start Bot and CLI TUI
 ```bash
 bmo
 ```
-*Note: If your local OpenCode instance is not running, BMO will automatically attempt to launch it.*
+If your local OpenCode server is not running, BMO will attempt to start it automatically.
 
-### 🌐 Launch the Web Chat Interface
-Starts the unified Node.js/Express Web Chat and opens a secure public Cloudflare Tunnel so you can chat from any web browser:
+### Start Webchat and Tunnel
 ```bash
 bmo web
 ```
+This launches the Node/Express webchat server and opens a secure public Cloudflare Tunnel, allowing you to access your chat session from any device.
 
-### 📡 Go Online (Peer Relay)
-Start a BFP (BMO Friendship Protocol) peer relay node to make your agent discoverable by other BMO peers on the registry:
+### Start BFP Relay (Optional)
+To make your agent discoverable by other BMO peers on the registry:
 ```bash
 bmo relay
 ```
-*   To run privately without listing on the public registry: `bmo relay --private`
-*   To stop the relay background services: `bmo relay --stop`
-
----
-
-## 🛠️ CLI Commands & Subcommands
-
-```bash
-bmo [command] [options]
-```
-
-| Command | Option | Description |
-|---|---|---|
-| `bmo` | — | Starts the Telegram bot & CLI TUI |
-| `bmo init` | — | Runs the interactive setup wizard |
-| `bmo web` | — | Starts Express Webchat + Cloudflare tunnel |
-| `bmo relay` | `[--private] [--stop]` | Starts/stops the BFP capability relay |
-| `bmo --version` | — | Prints the package version |
-| `bmo --update` | — | Automatically pulls and applies the latest updates |
-
----
-
-## ⚙️ Configuration & Storage
-
-All user configurations, chat databases, and logs are kept isolated in the user's home directory under `~/.bmo/`:
+Options:
+- `--private`: Run the relay and tunnel locally without registering on the public directory.
+- `--stop`: Terminate the background relay and tunnel processes.
 
-*   **`~/.bmo/.env`** — Bot tokens, model configurations, and ports.
-*   **`~/.bmo/data/bot.db`** — Shared SQLite database (WAL mode) containing all sessions, messages, memory, and custom agents.
-*   **`~/.bmo/logs/`** — Log files for the bot, webchat, and tunnel.
+## Command Reference
 
----
+- `bmo` - Launches the Telegram bot and the CLI TUI.
+- `bmo init` - Runs the interactive configuration wizard.
+- `bmo web` - Starts the webchat server and Cloudflare tunnel.
+- `bmo relay` - Controls the peer-to-peer relay.
+- `bmo --version` - Prints the installed version.
+- `bmo --update` - Checks for and pulls the latest updates.
 
-## 👥 Telegram interface
+## Storage and Configuration
 
-Use the persistent keyboard controls at the bottom of the chat, or the inline control menu (`/menu` command) to:
-- **🆕 New / 💾 Save / 📂 Load** sessions
-- **🤖 Choose Model** dynamically (e.g. OpenAI, Anthropic, DeepSeek, or local)
-- **⚡ Operation Modes**: `plan` (outline only), `ask` (clarifying questions first), or `execute` (write code and run commands)
-- **🎭 Agents & 🛠️ Skills**: Enable custom or generated personas and load specialized capabilities
-- **🌐 Chat on Web**: Dynamically launch a cloudflared-tunneled web interface directly from Telegram
+All configuration, logs, and database files are kept in the user home directory:
 
----
+- `~/.bmo/.env` - Your API tokens, ports, and default model configuration.
+- `~/.bmo/data/bot.db` - The shared SQLite database (WAL mode) containing session history, memory, and custom agents.
+- `~/.bmo/logs/` - Logs for the bot, CLI, webchat, and tunnel.
 
-## 📄 License
+## License
 
-MIT License. Developed by Aliwey.
+MIT

package/bin/bmo.js

@@ -136,19 +136,19 @@ Data lives in: ${BMO_HOME_DISPLAY}
   }
 
   // ── bmo init ──────────────────────────────────────────────────────────────
-  if (cmd === 'init') {
+  if (cmd === 'init' || cmd === '-init' || cmd === '--init') {
     require('../scripts/bmo_init.js');
     return;
   }
 
   // ── bmo web ───────────────────────────────────────────────────────────────
-  if (cmd === 'web') {
+  if (cmd === 'web' || cmd === '-web' || cmd === '--web') {
     require('../scripts/web_cmd.js');
     return;
   }
 
   // ── bmo relay [--private|--stop] ──────────────────────────────────────────
-  if (cmd === 'relay') {
+  if (cmd === 'relay' || cmd === '-relay' || cmd === '--relay') {
     process.argv = [process.argv[0], process.argv[1], ...args]; // pass flags
     require('../scripts/relay_cmd.js');
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliwey/bmo",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "BMO — AI coding assistant with Telegram, CLI & Web sync. One command, all frontends.",
   "keywords": ["ai", "coding-assistant", "telegram-bot", "cli", "opencode", "bfp"],
   "homepage": "https://github.com/aliwey/bmo",