Mob is a personal AI assistant that runs on your own machine. One service keeps
conversations in SQLite and serves a desktop app, a browser UI, a terminal UI and
the mob CLI, and it can answer you in Telegram, WeChat and email. The model can
use tools (a container sandbox, your mailbox, Cloudflare, MCP servers), and
anything with an effect waits for your approval.
Install
Section titled “Install”npm install -g usemob # or: bun add -g --trust usemobNightly builds, archives, upgrading and building from source are in Install.
mob tui # terminal UI; starts the service when neededmob open # sign a browser in to the running servicemob open --web # or sign in https://usemob.app to itmob start / status / stop # run the service in the backgroundmob serve --demo # foreground, with an offline demo modelWith no setup Mob answers with an offline demo model. Add a model provider for real replies, such as OpenRouter for free models:
mob provider add openrouter --key-stdinThen /models lists models and /model NAME switches the conversation. Type /
in the web UI or TUI to see and complete commands; /help lists them in
messaging apps.
In the TUI: Enter sends, Ctrl+J inserts a newline, F2 switches conversations, F3 shows tool details, F4 reviews approvals, Ctrl+S stops the reply, PgUp/PgDn scroll, Ctrl+Q exits. See the terminal UI for the rest.
Documentation
Section titled “Documentation”The documentation is at https://usemob.app/docs; the pages below are its sources. Start with the first line and go deeper as you need.
- Set up: model providers, configuration and the desktop app.
- Work with it: tools and approvals, the sandbox and schedules.
- Hand off coding: coding agents and plans.
- Connect it: Telegram, WeChat and email, MCP servers, skills and remote access.
- Everything else: all features, configuration keys and contributing.
Security
Section titled “Security”Report vulnerabilities privately, as described in SECURITY.md.
License
Section titled “License”MIT. AI Elements sources keep their Apache-2.0 license.