Installation & Sign In

Requirements

• VS Code 1.96 or newer
• An internet connection (the extension needs to reach mosayic-api-service-...run.app)
• A Mosayic account at app.mosayic.io

Install

1. Open VS Code.
2. Open the Extensions panel (Cmd/Ctrl + Shift + X or click the squares icon in the Activity Bar).
3. Search for Mosayic. The extension ID is mosayic.vscode-mosayic, published by mosayic.
4. Click Install.

The extension activates automatically when VS Code finishes loading (onStartupFinished). No restart required.

Sign in

1. Open the Command Palette (Cmd/Ctrl + Shift + P).
2. Run Mosayic: Sign In.
3. Your default browser opens to a Google OAuth consent screen.
4. Sign in with the same Google account you use on the Mosayic dashboard.
5. The browser redirects back to VS Code via the vscode:// protocol scheme.
6. Within a second or two, the status bar item (bottom-left of VS Code) changes to Mosayic: connected.

The extension stores your access and refresh tokens in VS Code’s secretStorage, which is backed by your OS keychain (macOS Keychain, Windows Credential Manager, libsecret on Linux). Tokens are refreshed automatically before they expire.

Caution

The dashboard and the extension must be signed in with the same Google account. If they aren’t, the dashboard pops up a modal warning you and refuses to send commands.

The status bar

The extension shows a single status bar item in the bottom-left of VS Code. Its label tells you the current connection state:

Status	Meaning
$(account) Mosayic: signed out	Not signed in. Click to sign in.
$(loading~spin) Mosayic: connecting	Establishing the WebSocket.
$(check) Mosayic: connected	Ready to receive commands from the dashboard.
$(loading~spin) Mosayic: reconnecting	Connection dropped; backing off and retrying.
$(warning) Mosayic: auth failed	Token rejected. Sign in again.
$(error) Mosayic: error	Something else went wrong. Click to view logs.

Clicking the status bar opens the “Mosayic WebSocket” output channel (when connected) or triggers Sign In (when signed out).

Open a workspace folder

The extension runs every command in the first folder of your VS Code workspace. If no folder is open, it falls back to your home directory — which is rarely what you want.

Even if you haven’t scaffolded a project yet, open some folder via File → Open Folder… so the extension has somewhere to work. The setup guide will create the actual project folder for you.

Sign out

Run Mosayic: Sign Out from the Command Palette. This:

• Clears all stored tokens
• Closes the WebSocket
• Re-arms the per-command consent prompts (in case you’d previously chosen “Allow All”)

Your local code and CLIs are not affected — gh, gcloud, etc. stay logged in independently.

Uninstall

Uninstall via the Extensions panel like any other extension. Tokens are cleared from secret storage as part of uninstall.

Updating

VS Code updates extensions automatically by default. You can also right-click the extension and pick Check for Updates. The changelog lives at github.com/mosayic-io/vscode-mosayic/blob/main/CHANGELOG.md.

After an update, the extension will reload itself and the status bar should return to “connected” within a few seconds. If it doesn’t, see Troubleshooting.