Commands

Open the Command Palette (Cmd/Ctrl + Shift + P) and type “Mosayic” to see them.

User-facing commands

`Mosayic: Sign In`

Starts the Google OAuth flow. Opens your browser for consent, then receives the callback via the vscode:// URI scheme. Times out after 2 minutes if you don’t complete the consent flow.

You’ll typically only run this once per machine — the extension keeps you signed in across VS Code restarts.

`Mosayic: Sign Out`

Clears all stored sessions and disconnects the WebSocket. Also re-enables per-command consent prompts (in case you’d previously chosen “Allow All”). Run this if you want to switch Mosayic accounts.

`Mosayic: Show Logs`

Opens the Mosayic WebSocket output channel. This is where the extension writes detailed logs of:

Sign-in flow events
WebSocket connection attempts and reconnections
Commands received from the backend, with redacted output
Errors

This is the first place to look when something isn’t working. Sensitive values (passwords, tokens, Bearer headers, URLs with embedded credentials) are automatically redacted.

`Mosayic: Reset Command Prompts`

If you previously approved a command with Allow All, re-running this command makes the extension prompt you for each new (non-allowlisted) command again. Useful if you got more permissive than you meant to.

`Mosayic: Check Docker`

Probes Docker by running docker info. Reports back:

✅ Docker is installed and the daemon is running
⚠️ Docker is installed but the daemon isn’t running (start Docker Desktop)
❌ Docker isn’t installed (with a link to download)

This check also runs once on extension activation. If Docker is missing or down, you’ll see a one-time warning notification.

Internal commands

These are invoked by the dashboard via deep links — you don’t typically run them yourself.

`Mosayic: Connect`

Triggered by the dashboard’s Open VS Code button via the vscode://mosayic.vscode-mosayic/wake URI. Forces a fresh WebSocket reconnection. Useful when the dashboard wants to be sure the extension is awake before sending a command.

`Mosayic: Focus`

Triggered by vscode://mosayic.vscode-mosayic/focus. Brings the most recently used Mosayic terminal to the front. The dashboard uses this after opening a long-running terminal command, so you can see what’s happening.

Developer commands

Hidden by default. Set mosayic.showDevCommands to true in VS Code settings to expose them.

`Mosayic: Switch Backend…`

Opens a QuickPick to choose between:

Production — https://mosayic-api-service-336793731775.us-east1.run.app
Dev — http://127.0.0.1:8090 (a backend running on your machine)
Custom — a URL you specify

Switching backends clears your existing session (you’ll need to sign in again on the new backend).

This is for Mosayic contributors developing the backend itself. End users should leave this alone.