Omnise Code Editor
Edit Omnise section code in Visual Studio Code or Cursor and keep your changes in sync with the Omnise editor.
The extension runs quietly in the background. When you select Edit code in Omnise, your chosen code editor opens the files for that section. Save a file to send the change back to Omnise.
Features
- Opens section files directly from the Omnise editor.
- Works with Visual Studio Code and Cursor.
- Sends saved changes back to Omnise automatically.
- Receives updates made in Omnise while the editing session is open.
- Opens the main Liquid file first so you can start editing immediately.
- Shows the connection status in the editor status bar.
Requirements
- Visual Studio Code 1.74 or later, or a compatible version of Cursor.
- The Omnise app and an editable section.
- The Omnise extension installed and enabled in the editor you want to use.
If you use both Visual Studio Code and Cursor, install the extension in both applications.
Getting started
- Install this extension in Visual Studio Code or Cursor.
- Open the Omnise editor in your browser.
- Select a section and choose Edit code.
- Choose Visual Studio Code or Cursor when asked.
- Allow your browser to open the selected application.
- Wait for Omnise to confirm the connection.
Omnise remembers your editor choice for future sessions.
Editing and saving
An editing session can include the following files:
| File |
Purpose |
template.liquid |
Liquid markup |
template.jsx |
JSX markup and behavior |
style.css |
Section styles |
script.js |
Section JavaScript |
schema.json |
Section settings definition |
data.json |
Complete section data |
Make your changes and save the file as usual. Saved changes are sent to the matching section in Omnise.
Keep the Omnise browser tab and your code editor open during the editing session. Closing either one ends the live connection.
Connection status
The status bar in the lower-right corner shows the current state:
Omnise WS:9812 — the extension is ready.Omnise WS:Off — the connection service could not start. Select the status item to try again.
The extension starts automatically when Visual Studio Code or Cursor opens. You do not need to start it manually.
Troubleshooting
The editor does not open
- Confirm that Visual Studio Code or Cursor is installed.
- Allow the browser prompt to open the external application.
- Return to Omnise and select the editor card again.
Omnise cannot connect
- Confirm that this extension is installed and enabled in the selected editor.
- Keep the selected editor open until Omnise finishes connecting.
- Check the status bar for
Omnise WS:9812.
- If the status shows
Omnise WS:Off, select it to retry.
- Close the other code editor if both Visual Studio Code and Cursor are running, then try again.
Saved changes do not appear in Omnise
- Make sure the Omnise browser tab is still open.
- Save the file again after the connection is restored.
- Do not rename the files created for the editing session.
- Reopen the section through Edit code if the session has ended.
Port 9812 is already in use
Only one running application can use the Omnise connection at a time. Close other Visual Studio Code or Cursor windows that may be running the extension, then reopen your preferred editor.
Privacy and security
The extension accepts connections only from your computer through 127.0.0.1. Section data is exchanged locally between the browser and your code editor. The extension does not expose its connection service to other devices on your network.
Support
If the issue continues, include your editor name, extension version, and the message shown by Omnise when you report it through the project issue tracker.
License
Released under the MIT License.
