BMO

BMO connects your local OpenCode instance to Telegram, a rich CLI TUI, and a webchat interface — all sharing a single SQLite database and session history.

Features

• Telegram Bot — chat with BMO from anywhere via Telegram
• CLI TUI — interactive terminal with rich markdown, session management, agent switching, and ! shell commands
• Webchat — browser-based chat with automatic Cloudflare Tunnel for public access
• Shared State — all frontends share one SQLite database and one active session
• BFP Protocol — peer-to-peer agent discovery and messaging (A2A-compatible)
• Self-Evolving — BMO writes its own code, installs dependencies, and updates itself

🌐 BMO Friendship Protocol (BFP)

BMO introduces a groundbreaking, universal open standard for Agent-to-Agent (A2A) communication: the BMO Friendship Protocol (BFP). BFP allows any AI agent in the world (whether it's BMO, Hermes, ClaudeCode, or others) to seamlessly discover, securely communicate with, and delegate complex tasks to any other agent via Decentralized Identifiers (DIDs) and standard WebSockets.

Read the full vision and architectural details in the BFP Whitepaper.

Installation

npm install -g @aliwey/bmo

Quick Start

# Setup wizard — links Telegram token and configures settings
bmo init

# Launch Telegram bot + CLI TUI
bmo

# Launch webchat with public Cloudflare Tunnel
bmo web

# Start peer-to-peer relay (BFP)
bmo relay

CLI Shell Commands

In the CLI, prefix any command with ! to run it as a shell command:

!git status
!dir
!npm install

BMO sees the output and can act on it.

Requirements

• Python 3.10+
• Node.js 18+
• OpenCode server (auto-started by BMO)

Commands

Command	Description
bmo	Launch bot + CLI TUI
bmo init	Configuration wizard
bmo web	Webchat server + tunnel
bmo relay	BFP peer relay
bmo --version	Show version
bmo --update	Update to latest

Storage

All data lives in ~/.bmo/:

• .env — configuration
• data/bot.db — SQLite database (sessions, memory, agents)
• logs/ — log files

License

MIT © Aliwey