usemob 0.0.0-nightly.20261030-896099c

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fdkevin0
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# Mob — local assistant
+
+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
+
+```bash
+npm install -g usemob      # or: bun add -g --trust usemob
+```
+
+Nightly builds, archives, upgrading and building from source are in
+[Install](docs/install.md).
+
+## Use
+
+```bash
+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 model
+```
+
+With no setup Mob answers with an offline demo model. Add a model provider
+for real replies, such as OpenRouter for free models:
+
+```bash
+mob provider add openrouter --key-stdin
+```
+
+Then `/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](apps/tui/README.md) for the rest.
+
+## Documentation
+
+The documentation is at https://usemob.app/docs; the pages below are its
+sources.
+
+- [Model providers](docs/features/providers.md)
+- [Configuration and running the service](docs/features/configuration.md)
+- [Tools and approvals](docs/features/tools-and-approvals.md)
+- [Sandbox](docs/features/sandbox.md)
+- [Messaging channels](docs/features/channels.md): Telegram, WeChat iLink, email
+- [Plugins: email and Cloudflare](docs/features/plugins.md)
+- [MCP servers](docs/features/mcp.md)
+- [All feature pages](docs/features/README.md) and [architecture](docs/architecture.md)
+
+## License
+
+[MIT](LICENSE). AI Elements sources keep
+[their Apache-2.0 license](packages/app/src/ai-elements/SOURCE.md).

package/bin/install.js

@@ -0,0 +1,25 @@
+// The postinstall script of the usemob npm package. On Linux and macOS it puts
+// this machine's binary in place of the bin/mob.js launcher, so `mob` runs
+// natively, without Node.js or Bun. npm runs it; Bun runs it with
+// `bun add -g --trust usemob`. When it does not run, or fails, the launcher
+// stays and needs Node.js; a failure is reported but does not fail the install.
+'use strict';
+const fs = require('node:fs');
+const path = require('node:path');
+
+if (process.platform !== 'win32') {
+	const pkg = `usemob-${process.platform}-${process.arch}`;
+	try {
+		const binary = require.resolve(`${pkg}/bin/mob`);
+		const launcher = path.join(__dirname, 'mob.js');
+		const temp = launcher + '.tmp';
+		fs.rmSync(temp, { force: true });
+		// A hard link saves a second copy of the binary; across file systems, copy it.
+		try { fs.linkSync(binary, temp); } catch { fs.copyFileSync(binary, temp); }
+		fs.chmodSync(temp, 0o755);
+		// The global bin link points at mob.js, so the binary takes its name.
+		fs.renameSync(temp, launcher);
+	} catch (error) {
+		console.warn(`usemob: kept the Node.js launcher, so mob needs Node.js (${pkg}: ${error.code ?? error.message})`);
+	}
+}

package/bin/mob.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+// The `mob` command of the usemob npm package until scripts/npm/install.js
+// replaces it with the binary, and on Windows. npm and bun install only the
+// platform package that matches this machine (usemob-OS-ARCH); this runs its
+// compiled binary, which needs neither Node.js nor Bun.
+'use strict';
+const { spawn } = require('node:child_process');
+
+const pkg = `usemob-${process.platform}-${process.arch}`;
+let binary;
+try {
+	binary = require.resolve(`${pkg}/bin/${process.platform === 'win32' ? 'mob.exe' : 'mob'}`);
+} catch {
+	console.error(`mob: ${pkg} is not installed. Mob is published for linux-x64, linux-arm64, darwin-x64, darwin-arm64 and win32-x64;`);
+	console.error('reinstall without --no-optional, or download an archive from https://github.com/fdkevin0/mob/releases');
+	process.exit(1);
+}
+
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit' });
+// Ctrl+C already reaches the binary through the terminal; other signals are passed on.
+process.on('SIGINT', () => {});
+for (const signal of ['SIGTERM', 'SIGHUP']) process.on(signal, () => child.kill(signal));
+child.on('error', error => {
+	console.error(`mob: ${error.message}`);
+	process.exit(1);
+});
+child.on('exit', (code, signal) => {
+	if (signal) {
+		process.removeAllListeners(signal);
+		process.kill(process.pid, signal);
+	} else process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+	"name": "usemob",
+	"version": "0.0.0-nightly.20261030-896099c",
+	"description": "Local assistant with desktop, terminal and background service",
+	"license": "MIT",
+	"homepage": "https://usemob.app",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/fdkevin0/mob.git"
+	},
+	"bin": {
+		"mob": "bin/mob.js"
+	},
+	"scripts": {
+		"postinstall": "node bin/install.js"
+	},
+	"files": [
+		"bin"
+	],
+	"optionalDependencies": {
+		"usemob-linux-x64": "0.0.0-nightly.20261030-896099c",
+		"usemob-linux-arm64": "0.0.0-nightly.20261030-896099c",
+		"usemob-darwin-x64": "0.0.0-nightly.20261030-896099c",
+		"usemob-darwin-arm64": "0.0.0-nightly.20261030-896099c",
+		"usemob-win32-x64": "0.0.0-nightly.20261030-896099c"
+	}
+}