The web IDE

Browse, edit and commit your project's files in the browser at ide.zeonsystems.app.

The web IDE at https://ide.zeonsystems.app opens your cloud projects in the browser: a file tree, an editor, and a commit button. It works on the same cloud project that zeon sync pushes to and pulls from, on its single branch, main. There is no separate IDE copy of your work.

Use it for quick checks and small edits, for example to confirm a skill landed under skills/<name>/ or to fix a value in a workflow JSON. For day-to-day development, the CLI is the main surface: see The development loop.

Opening a project

The IDE uses your zeonsystems.app sign-in (see Signing in). If you are not signed in, it sends you to the sign-in page and back.

The first screen, Your projects, lists your projects. New project creates one. Click a project card to open its workspace.

The workspace has the file tree on the left and the editor on the right. The tree shows folders first, then files, each in alphabetical order. A project opens with every folder collapsed: click a folder to open or close it. When a file is open in the editor, the folders above it open so you can see where it is.

The editor is Monaco, the editor used in VS Code. It highlights .py, .json, .md, .yaml/.yml, .ts/.tsx and .js/.jsx files and opens anything else as plain text. The status bar at the bottom shows the path of the open file.

Editing

Click a file to open it and type to edit. Other ways to change the project:

  • New file in the top bar opens a New item dialog. Pick a kind (Skill, Workflow, World, Canvas or Custom file) and a name, and the IDE adds the files that kind needs. Canvas attaches a canvas to an existing workflow and updates that workflow's JSON.
  • Mesh database in the top bar shows the shared mesh database catalog, read-only.
  • Right-click in the tree for New file, New folder and Delete.

Renaming a file is not supported. Create a file with the new name, copy the content across, and delete the old one.

How changes reach the project

Edits, new files and deletes stay in the browser tab until you commit. The status bar reads Synced while nothing has changed and Unsaved changes once something has. The Commit (N) button in the top bar counts the pending changes.

Click Commit (N), enter a message, and click Commit & Push. The IDE writes one commit to the cloud project's main, as zeon push does. Run zeon sync (or zeon pull) in your working tree to get it on your computer.

Until you commit, leaving the workspace, signing out or closing the tab discards your changes. The IDE asks before it does.

When the cloud moved on

If the cloud project got a new commit while you had it open (from zeon push, the web app, or another tab), your commit is refused and the workspace shows Diverged from cloud. Reload from cloud loads the latest version and discards your uncommitted changes, so copy anything you want to keep first. You can also make the change in your working tree and run zeon sync; see Conflicts and a diverged project.

What lives elsewhere

  • History and diffs: zeon log and zeon diff. The IDE has neither.
  • Branches: the IDE shows main and works only on main.
  • Adding objects to a project: zeon new object or the web app; see Adding an object.
  • Building, previewing and running workflows: the web app at zeonsystems.app. See The main app.

Did this page help you?