CodeLens actions: Adds buttons above each @nova.program to quickly run NOVA programs: Run, Debug, and Tune path.
Trajectory fine-tuning (Trajectory tuner): Interactively step through trajectories, jog the robot, and save adjusted poses.
Instance selection: Configure which NOVA instance to connect to via extension settings.
Using the extension
Configure the NOVA instance
Open VS Code settings and search for Wandelbots NOVA.
Set your NOVA instance address as the NOVA API host.
Run and debug from your code
The extension scans your Python files for @nova.program and displays CodeLens buttons above each decorated function:
Run: Execute the program on the configured NOVA instance.
Debug: Launch with debugger support.
Tune Path: Start interactive path tuning.
Trajectory fine-tuning (Trajectory Tuner)
Use Trajectory Tuner to iteratively adjust trajectory waypoints and actions:
Click Tune Trajectory above a @nova.program.
Execution will pause at each execution call.
In the Fine-Tuning panel, use the following controls:
Forward/Backward: Hold to step through the trajectory in either direction.
Snap to point: Toggle on to stop at every action/keyframe; toggle off to glide continuously.
Fine-tune points:
Use the built-in Jogging Panel to move a robot to the desired pose.
Save to create a new point, updating the path.
Continue stepping and saving until the trajectory is tuned to your needs, then exit the Trajectory Tuner.
Local development
Running Extension Development mode
Install the dependencies:
pnpm install
Run the Extension Development Environment
Inside the editor, open src/extension.ts and press F5 or run the command Debug: Start Debugging from the Command Palette. This will compile and run the extension in a new Extension Development Host window.
Any changes in the react app (app/) will trigger a rebuilt managed by vite. After the buid has been finished, refresh the Development Host and the changes take effect.
Build and install the extension from .vsix
Build & package the extension:
pnpm run package:vscode
Install the extension in VS Code via VSIX. Search for the command Extensions: Install from VSIX... and select the created file.
Reload the extension with the command Developer: Reload Window.
You should now see the extension in the Extensions view & the Wandelbots logo in the activity bar.
Update on Pose API schema changes
run ./scripts/bundle-openapi.sh to bundle the Pose Service OpenAPI spec into a single self-contained file
run pnpm run pose:types to regenerate ./src/types/pose.types.ts (this requires you to have java and maven installed)
