BMO

A GameBoy-style terminal. Cute BMO face, round buttons, Blue Water logo font, a real shell, embedded terminals, and an idle screen-saver where BMO blinks and looks around.

• Linux and Windows
• Double-click to launch (desktop entry on Linux, .pyw on Windows)
• Install via curl | npm | bun | brew

Requirements

The installer checks for these and installs any that are missing for you (it uses each tool's own one-liner - no manual steps):

• Python 3 with tkinter (system package)
• Pillow (optional - BMO's face saver)
• python-xlib (Linux, optional - minimize/restore hotkey)
• xterm (Linux, optional - the embedded interactive terminal)
• opencode (optional - powers the mo command; installed via curl -fsSL https://opencode.ai/install | bash)
• Ollama (optional - powers BMO's AI chat friend; free + offline, no API key; the installer offers curl -fsSL https://ollama.com/install.sh | sh)

AI chat friend

BMO is not just a terminal - it's a friend. Just type something and it chats back (a small local model, fully offline, no API key, nothing leaves your machine):

hello!

• Memory: BMO asks your name on first launch and remembers you - your name and your conversations are saved in ~/.local/share/bmo/chat.json.
• Commands are prefixed with /. Anything without a / is chat.
• First chat auto-downloads a small model (qwen2.5:0.5b, ~400MB) via Ollama.
• /help, /name <n>, /memory, /forget, /model [name] manage the friend features.

Install

curl (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/lmdelm-dev/bmo/main/install.sh | bash

Installs to ~/.local/share/bmo, adds a bmo command, a desktop entry, and the Blue Water logo font. It also bootstraps any missing dependencies (Python 3 + tkinter, Pillow, python-xlib, xterm, opencode) using their standard installers. Run it with bmo or from your app menu.

npm

npm install -g @lmdelm-dev/bmo
bmo

bun

bun add -g @lmdelm-dev/bmo
bmo

brew (macOS / Linux)

brew tap lmdelm-dev/tap https://github.com/lmdelm-dev/homebrew-tap
brew install bmo

From source

git clone https://github.com/lmdelm-dev/bmo.git
cd bmo
./bmo

Windows

Install Python (tick "Add python.exe to PATH", plus tkinter), then:

• Double-click bmo.pyw, or
• Open a terminal and run bmo.bat, or
• npm install -g @lmdelm-dev/bmo && bmo

Usage

• Just type and BMO chats with you (local AI, free + offline)
• Commands start with /: /ls, /pwd, /mo (opencode), /gmo (w3m), /fs (fullscreen), /clear, /quit, /help
• /name <name> - tell BMO your name, /memory - what it remembers, /forget - clear memory, /model [name] - change the AI model
• The blue _ button minimizes; on Linux bring it back with Ctrl+Alt+B
• The red X button closes BMO
• After 60s idle, BMO falls asleep (blinks; move mouse or press a key to wake)

Packaging notes for maintainers

• install.sh - the curl installer (BMO_REPO/BMO_BRANCH env vars override the source)
• package.json + cli.js - the npm/bun package (@lmdelm-dev/bmo)
• Formula/bmo.rb - Homebrew formula (lives in the lmdelm-dev/homebrew-tap repo)
• scripts/release.sh - fills the real tarball sha256 into the Formula
• .github/workflows/ci.yml - lint checks on push, checksum verification on tags

Release checklist (publish a new version)

# 1. commit your changes, then create the tag
git add -A
git commit -m "My change"
git tag v0.1.0          # bump versions in package.json and Formula too

# 2. push the repo and the tag
git remote add origin https://github.com/lmdelm-dev/bmo.git
git push -u origin main
git push origin v0.1.0

# 3. now that the tarball exists on GitHub, get the real checksum:
./scripts/release.sh v0.1.0   # prints the sha256 and updates Formula/bmo.rb

Note: a tag commit cannot contain its own tarball checksum (it would change the tarball). The computed sha256 must live in the Homebrew tap repo (a separate git repo), which scripts/release.sh produces for you.

After that:

• npm / bun: npm publish (must be run from a machine logged into npm; requires an npm account with @lmdelm-dev scope access).
• Homebrew: push the updated Formula/bmo.rb to the lmdelm-dev/homebrew-tap repo; brew install bmo then works.

CI lints on push, and on each tag it re-packages the GitHub tarball to confirm it builds.

License

MIT