Skip to content

Configuration keys

Generated from apps/mob/src/config.ts; run bun run generate:configdocs.

Explicit CLI flags > nonempty MOB_ environment variables > configuration file > defaults. Empty environment values are ignored consistently; use a flag or file value to clear a string. There is no .env loader. Restart after changing the process environment.

Keys map to flags by replacing dots/underscores with hyphens, and to environment variables by replacing dots with underscores, uppercasing and prefixing MOB_. The config selector chooses the file before loading it and cannot appear inside that file. The file is YAML (config.yaml) or JSON (config.json).

File key CLI flag Environment Default Purpose
config --config MOB_CONFIG XDG config home/mob/config.yaml Configuration file path (selector only; not a file field)
data_dir --data-dir MOB_DATA_DIR XDG data home/mob (existing legacy database reused) SQLite, token and conversation workspaces; restart required
state_dir --state-dir MOB_STATE_DIR XDG state home/mob Background logs; restart required
addr --addr MOB_ADDR 127.0.0.1:8787 Local service loopback IP and port; restart required
demo --demo MOB_DEMO false Use offline model simulation; restart required
driver --driver MOB_DRIVER mob Model driver: mob (Mob’s own) or aisdk (the AI SDK’s provider packages, being tried); restart required
max_tool_steps --max-tool-steps MOB_MAX_TOOL_STEPS 20 Model calls per turn (1-100)
web_url --web-url MOB_WEB_URL https://usemob.app Public web UI URL; an empty flag or file value disables it
token --token MOB_TOKEN "" Local access token (at least 32 bytes); empty uses the managed token file; restart required; sensitive: prefer a protected file or environment over argv
sandbox.enabled --sandbox-enabled MOB_SANDBOX_ENABLED false Expose the container sandbox tool
sandbox.runtime --sandbox-runtime MOB_SANDBOX_RUNTIME "" Container runtime: containerd, apple or wslc; empty selects by platform
sandbox.image --sandbox-image MOB_SANDBOX_IMAGE python:3.13-slim Container image for commands
sandbox.network --sandbox-network MOB_SANDBOX_NETWORK "" Container network; none disables it, empty uses runtime default
sandbox.cpus --sandbox-cpus MOB_SANDBOX_CPUS 0 Nonnegative CPU limit; zero uses runtime default
sandbox.memory --sandbox-memory MOB_SANDBOX_MEMORY "" Memory limit with unit, at least 64m; empty uses runtime default
sandbox.isolation --sandbox-isolation MOB_SANDBOX_ISOLATION "" gvisor requires containerd; empty uses runtime default
agents.confinement --agents-confinement MOB_AGENTS_CONFINEMENT host Where coding agents run: host asks the owner before what leaves their worktree; cloud, only inside a disposable Claude Code cloud environment, lets them do anything there without asking; restart required
mcp_servers --mcp-servers MOB_MCP_SERVERS {} MCP server map; JSON object in flags/environment, native map in files; sensitive: prefer a protected file or environment over argv
mcp_registry.url --mcp-registry-url MOB_MCP_REGISTRY_URL https://registry.modelcontextprotocol.io MCP registry the model searches for remote servers to install
mcp_registry.namespaces --mcp-registry-namespaces MOB_MCP_REGISTRY_NAMESPACES "" Comma-separated registry name globs, such as com.cloudflare.mcp/*, the model may install from; empty offers only Mob’s own list

This reference covers runtime configuration. Provider keys and plugin settings use their own stores; command actions such as open –print are not settings. XDG_* directory conventions and CI/build variables belong to their respective tools.

See Configuration for file safety and reload behavior; Sandbox and MCP describe their execution and environment boundaries.