Skip to main content
Public Preview

Spatial AI Coding Assistant by Wherobots
The Spatial AI Coding Assistant by Wherobots turns VS Code and any Code OSS-based editors 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 your editor. The Spatial AI Coding Assistant is an editor extension that ships as a standard .vsix package and runs in any editor based on Code OSS, including VS Code, Cursor, Windsurf, Kiro, Positron, Antigravity, Trae, and VS Codium. See Supported Editors for install commands and editor-specific notes.
  1. Run one of the following commands to install the extension, or install from the marketplace for your editor: 
    code --install-extension wherobots.wherobotsjobsubmit
    If your editor prompts you to install a missing dependency extension (e.g., Jupyter), click Install and Reload to install it and reload the window. The Wherobots extension depends on other extensions that may not be pre-installed in all editors.
    https://marketplace.visualstudio.com/items?itemName=wherobots.wherobotsjobsubmit
    See Supported Editors for the full list of tested editors and editor-specific notes.
  2. In your editor, open the Command Palette.
    You can open the Command Palette by pressing ⌘ + Shift + P on macOS, Ctrl + Shift + P on Windows/Linux.
    1. In the Command Palette, type Wherobots.
    2. Click Wherobots: Generate API Key on Wherobots Cloud to create an API key, or click Wherobots: Set API Key to enter an existing API key.
    3. Enter your Wherobots API key when prompted.
    4. Verify installation by typing Wherobots in the Command Palette. You should see commands like Wherobots: Create Workspace, Wherobots: Submit Job, and Wherobots: Open Settings.
  3. Pin the extension to your sidebar for easy access. See Pin the Extension for easy access below. Post-install, consult AI-Assisted Notebook Development to get started. Professional and Enterprise Organizations can also Submit Job Runs.

​
Key capabilities

The Spatial AI Coding Assistant provides the following core capabilities:
Start a Workspace in Wherobots to provision a remote runtime and connect to that runtime’s kernel.Use your AI Assistant like GitHub Copilot to create local Jupyter notebooks. Then you can connect these notebooks to remote Wherobots runtimes and run notebooks against cloud-backed compute resources.Empower your AI assistants with the Wherobots MCP Server to execute spatial SQL and Python workflows, query your data catalogs, and more—all from your local notebook interface.
Requires a Professional or Enterprise Organization Edition.
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 your editor 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 your editor with no manual configuration required.
Requires a Professional or Enterprise Organization Edition.
Create, start, stop, and dismiss workspaces directly from your editor’s sidebar. Each workspace provisions a runtime — a dedicated compute cluster — in Wherobots Cloud. Stopping a workspace tears down the runtime and halts billing.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:
  • A supported Code OSS-based editor — Visual Studio Code (VS Code) version 1.85 or later, or any Code OSS-based editor such as Cursor, Windsurf, Kiro, Positron, Antigravity, Trae, or VS Codium.
  • A Wherobots Account within a Community, Professional, or Enterprise Edition Organization.
    Organization Availability: Available to all Wherobots Organization Editions.
  • Active GitHub Copilot subscription or your editor’s equivalent AI assistant/subscription (for AI-assisted features).

​
Install Spatial AI Coding Assistant extension

The Spatial AI Coding Assistant by Wherobots is available on the marketplace for VS Code and Code OSS based editors. Install the extension from the marketplace or via the command line with the appropriate CLI command for your editor.

​
Supported editors

The Spatial AI Coding Assistant ships as a standard VS Code extension (.vsix) and works with any editor based on Code OSS.
Don’t see your editor? Any Code OSS-based editor that supports .vsix extensions should work.Install via the command line by running <editor-cli> --install-extension wherobots.wherobotsjobsubmit, where <editor-cli> is your editor’s CLI command (e.g. code, cursor, windsurf, kiro, antigravity), or download the .vsix file from Open VSX.
To use the extension, install it from the Extensions Marketplace in one of the following ways:
Run the following command in your terminal:
code --install-extension wherobots.wherobotsjobsubmit
If your editor prompts you to install a missing dependency extension (e.g., Jupyter), click Install and Reload to install it and reload the window. The Wherobots extension depends on other extensions that may not be pre-installed in all editors.

​
Configure the extension and verify the installation

​
Configure the extension

After installation, set your API key to connect to Wherobots Cloud.
These steps apply to VS Code, Cursor, Windsurf, Kiro, Positron, Antigravity, Trae, VS Codium, and other Code OSS editors. All use the same Command Palette and extension settings.
1

Open the Command Palette

To open the Command Palette, click the search bar at the top of your editor and type >.Command Palette
You can also press ⌘ + Shift + P on Mac, Ctrl + Shift + P on Windows/Linux.
2

Set your API key

  1. If you don’t have an API key yet, click Wherobots: Generate API Key on Wherobots Cloud to create one.
  2. Click Wherobots: Set API Key and enter your existing or newly created Wherobots API key when prompted, then press Enter.
API keys are stored securely in your editor’s Secret Storage.

​
Verify the installation

To confirm the extension is installed and configured correctly:
1

Open the Command Palette

To open the Command Palette, click the search bar at the top of your editor and type >.Command Palette
You can also press ⌘ + Shift + P on Mac, Ctrl + Shift + P on Windows/Linux.
2

Confirm available commands

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

​
Pin the Extension for easy access

If the Spatial AI Coding Assistant extension is pinned to your sidebar, you can also create a new workspace by clicking the Create Workspace button.
Create Workspace button in the Wherobots sidebar
To pin the Wherobots extension to the sidebar:
1

Pin the extension

Right-click the Activity Bar (the vertical icon bar on the left side of your editor).A menu will appear showing all available extensions.
2

Select the extension

To pin the extension, find Wherobots in the list and click on it to ensure it’s checked.
Wherobots extension checked in the Activity Bar
Now you’ll have easy access to the extension in your editor’s sidebar.

​
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. Available to Professional and Enterprise Organizations only.

​
Settings reference

All settings are under the wherobotsjobsubmit section in your editor’s Settings. To access these settings, enter Wherobots: Open Settings from the Command Palette in your editor. The following settings are available for the extension:
​
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.