Skip to main content
Public Preview

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 code command to install the extension or click Install from the VS Code Extensions Marketplace: 
    code --install-extension wherobots.wherobotsjobsubmit
  2. In VS Code, open the Command Palette (⌘ + Shift + P on macOS, Ctrl + Shift + P on Windows/Linux).
  3. Enter Wherobots: Set API Key.
  4. Enter your Wherobots API key.
  5. Verify installation by typing Wherobots in the Command Palette. You should see commands like Create Workspace, Submit Job, and Open Settings. Post-install, consult AI-Assisted Notebook Development to get started. Professional and Enterprise Organizations can also Submit Job Runs from VS Code.

​
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.
Requires a Professional or Enterprise Organization Edition.
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.
Requires a Professional or Enterprise Organization Edition.
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.
Requires a Professional or Enterprise Organization Edition.

​
Before you start

Ensure you have the following:
  • Visual Studio Code (VS Code) version 1.85 or later
  • A Wherobots Account within a Community, Professional, or Enterprise Edition Organization.
    Organization Availability: Available to all Wherobots Organization Editions.
  • Active GitHub Copilot subscription.

​
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 and verify the installation

​
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. Available to Professional and Enterprise Organizations only.
​
region
string
Default cloud region for job submission. If empty, organization default is used. Available to Professional and Enterprise Organizations only.
​
instanceSize
string
Default runtime size for job submissions. If empty, organization default is used. Available to Professional and Enterprise Organizations only.
​
timeout
number
Default job timeout in seconds for submissions. Available to Professional and Enterprise Organizations only.
​
mcpServerEnabled
boolean
Enables or disables Wherobots MCP server exposure to AI assistants. Available to Professional and Enterprise Organizations only.
​
apiBaseUrl
string
Overrides the Wherobots API base URL. Leave empty for production default.
​
mcpServerRuntimeId
string
Optional runtime ID header for MCP queries. Available to Professional and Enterprise Organizations only.
​
mcpServerRuntimeRegion
string
Optional runtime region header for MCP queries. Available to Professional and Enterprise Organizations only.
​
mcpServerQueryTimeout
number
Optional timeout (seconds) header for MCP queries. Available to Professional and Enterprise Organizations only.
​
jupyterIntegrationEnabled
boolean
Enables or disables Wherobots in the Jupyter kernel picker.

​
Next steps

After installing and configuring the extension, explore its capabilities:
  • AI-Assisted Notebook Development — Create and connect local notebooks to remote Wherobots compute and develop with GitHub Copilot.
  • Workspaces & Usage — Create, start, stop, and destroy notebook workspaces.
  • Submit Job Runs — Submit Python scripts as Wherobots job runs from VS Code. Available to Professional and Enterprise Organizations only.