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.
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 needed
mob open # sign a browser in to the running service
mob open --web # or sign in https://usemob.app to it
mob start / status / stop # run the service in the background
mob 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.
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.
Report vulnerabilities privately, as described in SECURITY.md.
MIT. AI Elements sources keep their Apache-2.0 license.