Skip to main content
Spatial AI Coding Assistant by Wherobots
The Spatial AI Coding Assistant by Wherobots turns VS Code into an agentic geospatial engineering workspace. Install the extension to manage workspaces, create and connect local notebooks to remote compute, submit jobs, and enable AI-assisted geospatial development — all without leaving VS Code.
  1. Run the following to install the extension or search Wherobots in the VS Code Extensions Marketplace: 
    code --install-extension wherobots.wherobotsjobsubmit
  2. Open the Command Palette (⌘ + Shift + P).
  3. Enter Wherobots: Set API Key. Enter your Wherobots API key.
  4. Verify by typing Wherobots in the Command Palette. You should see commands like Create Workspace, Submit Job, and Open Settings.

​
Key capabilities

The Wherobots VS Code extension provides the following core capabilities:
Start a Wherobots workspace, connect to a kernel, ask Copilot Chat to generate notebook code, and run it against cloud-backed resources. Create and connect local Jupyter notebooks to remote Wherobots compute with automatic kernel selection. See AI-Assisted Notebook Development.
Instead of starting from scratch, ask your AI assistant to generate entire notebooks with natural language prompts.The extension automatically configures the Wherobots MCP Server in VS Code to empower your AI assistants to perform geospatial Q&A and execute spatial SQL and Python workflows.
Query your data catalogs and more by empowering your AI assistants to perform geospatial Q&A and execute spatial SQL and Python workflows. The extension automatically configures the Wherobots MCP Server in VS Code with no manual configuration required.
Create, start, stop, and dismiss workspaces directly from the VS Code sidebar. Open related surfaces like the Wherobots Cloud Console, Spark UI, and Jupyter URLs without switching away from your editor. See Workspaces & Usage.
Submit the current .py file to Wherobots Cloud with configurable runtime, region, timeout, and arguments. Supports inline job configuration via Python comments. See Submit Job Runs.

​
Before you start

Ensure you have the following:

​
Install Spatial AI Coding Assistant extension

To use the extension, install it from the Extensions Marketplace in one of the following ways:
To install from the command line, run the following command in your terminal:
code --install-extension wherobots.wherobotsjobsubmit

​
Configure the extension

After installation, set your API key to connect to Wherobots Cloud.
1
On the Menu Bar, go to View > Command Palette.
Keyboard Shortcut: Alternatively, you can use the following keyboard shortcut: ⌘ + ⇧ + P on Mac, Ctrl + Shift + P on Windows/Linux to open the VS Code Command Palette.
2
Enter Wherobots: Set API Key and enter your Wherobots API key when prompted.If you haven’t created an API key yet, enter Wherobots: Generate API Key on Wherobots Cloud to create an API key within the Wherobots Cloud UI.
API keys are stored securely in VS Code Secret Storage. The extension connects to the Wherobots Cloud production API by default. To use a custom API endpoint, set the wherobotsjobsubmit.apiBaseUrl setting in VS Code Settings.

​
Verify the installation

To confirm the extension is installed and configured correctly:
1
In VS Code, go to View > Command Palette and type Wherobots.
2
Type Wherobots to see the available extension commands. You should see commands including:
  • Wherobots: Set API Key
  • Wherobots: Create Workspace
  • Wherobots: Submit Job
  • Wherobots: Refresh Workspaces
  • Wherobots: Open Settings
  • Wherobots: Install Jupyter Extension

​
Settings reference

All settings are under the wherobotsjobsubmit section in VS Code Settings. To access these settings, enter Wherobots: Open Settings from the Command Palette.
​
scriptPath
string
Cloud storage path for submitted scripts. If empty, the extension uses a managed default path.
​
region
string
Default cloud region for job submission. If empty, organization default is used.
​
instanceSize
string
Default runtime size for job submissions. If empty, organization default is used.
​
timeout
number
Default job timeout in seconds for submissions.
​
mcpServerEnabled
boolean
Enables or disables Wherobots MCP server exposure to AI assistants.
​
apiBaseUrl
string
Overrides the Wherobots API base URL. Leave empty for production default.
​
mcpServerRuntimeId
string
Optional runtime ID header for MCP queries.
​
mcpServerRuntimeRegion
string
Optional runtime region header for MCP queries.
​
mcpServerQueryTimeout
number
Optional timeout (seconds) header for MCP queries.
​
jupyterIntegrationEnabled
boolean
Enables or disables Wherobots in the Jupyter kernel picker.

​
Next steps

After installing and configuring the extension, explore its capabilities: