Settings

All Mosayic settings live under the mosayic.* namespace. Open Settings (Cmd/Ctrl + ,) and search for “mosayic” to see them all.

mosayic.environment

Which Mosayic backend to talk to.

Value	Backend
prod (default)	Production Cloud Run service
dev	http://127.0.0.1:8090 — a backend you run locally
custom	The URL in mosayic.apiUrl

Most users should leave this as prod. The other options are for Mosayic contributors developing the backend.

mosayic.apiUrl

The URL to use when mosayic.environment is custom. Ignored otherwise. Must be a valid http:// or https:// URL — the extension refuses plaintext HTTP for non-localhost URLs (see Security).

Default: https://mosayic-api-service-336793731775.us-east1.run.app.

mosayic.confirmCommands

When the extension should prompt for your confirmation before running a command sent by the backend.

Value	Behaviour
allowlisted (default)	Auto-approve commands using known CLIs (gh, gcloud, expo, eas, npm, npx, node, nvm, docker, git, supabase, mkdir, unzip, sed, jq, ssh-keygen, rm, mv, cd, printf, uv, test, [, hostname, lsof, .). Prompt for anything else.
always	Prompt for every command.
never	Never prompt. Use with care — see Security.

When prompted, you can choose:

• Allow — run this one command
• Allow All — auto-approve all subsequent non-allowlisted commands for this VS Code session
• Deny — refuse this command (the dashboard will see an error)

If you ever choose “Allow All” and want to undo it, run Mosayic: Reset Command Prompts.

mosayic.showDevCommands

Show developer-only commands (currently just Mosayic: Switch Backend…) in the Command Palette.

Default: false. Set to true only if you’re developing Mosayic itself.

mosayic.windowsShell

(Windows only — ignored on macOS and Linux.)

Which shell the extension uses to run commands.

Value	Shell
auto (default)	cmd.exe. Recommended for most users.
cmd	cmd.exe explicitly.
gitbash	Git Bash, looked up at standard install paths.
pwsh	PowerShell 7 if installed, else Windows PowerShell.

auto exists because the default Windows shell varies (some installations have WSL Bash on the path, which causes confusing failures). cmd.exe is the safest baseline.

If you have a specific shell preference (e.g. you do everything in Git Bash and want shell scripts to work the same in Mosayic), pick it explicitly.

Note

Settings can be set globally (User Settings) or per-project (Workspace Settings). Mosayic settings are typically global — there’s no reason to vary confirmCommands per project, for instance.

Setting via settings.json

If you’d rather edit JSON than use the GUI, the keys are:

{
  "mosayic.environment": "prod",
  "mosayic.confirmCommands": "allowlisted",
  "mosayic.showDevCommands": false,
  "mosayic.windowsShell": "auto"
}

Place this in your User settings.json (open with Preferences: Open User Settings (JSON)).