Rumatadocs
Browse documentation

Code editor, file browser, and Git controls

Understand the full development editor, the read-only source viewer, and the actions that save files or push them to Git.

Step-by-step guidance.

Before you start

  • Open the named screen in Rumata. Available controls may depend on your account, permissions, and resource state.

Rumata’s code actions

Open System Explorer → Code. Eligible accounts get the full editor connected to the development machine; the fallback frontend source viewer is read-only.

ControlWhat it does
Save ChangesWhen unsaved files are detected, ask the editor to save them to the development machine. Saving does not publish the website.
Push to GitRequest the development machine’s Git push flow. Wait for its completion message and inspect errors before deploying.
Editor Unavailable → Try AgainRetry starting or reconnecting the development editor.
Upgrade / dismiss overlayReview the plan required for full code access or dismiss the upgrade overlay to browse the available read-only files.

Full development editor

The Code screen uses code-server, an editor based on the open-source VS Code interface. Its menus can vary with the installed version and extensions. Use the reference below for the editor’s main controls. Extensions provide their own commands.

ControlWhat it does
Application MenuOpen the editor’s file, edit, view, navigation, and terminal commands.
ExplorerBrowse workspace folders. Expand a folder or open a file; the selected file appears in an editor tab.
SearchFind text across the workspace. Review matches before using replacement actions, which edit files.
Source ControlInspect changed files and Git differences. Commit records a version; push sends commits to the remote repository.
Run and DebugOpen the editor’s debugging tools. Starting a program can execute code in the development machine.
ExtensionsInspect or manage editor add-ons. Availability can differ from desktop VS Code.
Open Quick AccessFind files and commands from the editor’s top bar.
Go Back / Go ForwardMove through editor navigation history, independently of the app preview history.
Customize Layout / Toggle Primary Side Bar / Toggle Panel / Toggle Secondary Side BarArrange the editor’s file sidebar, lower panel, and secondary sidebar.
Explorer → Views and More Actions / Outline / TimelineChoose explorer views, inspect the current file’s structure, or review its available history.
Manage / AccountsOpen editor settings or editor-provider account controls. These are separate from your Rumata account menu.
Branch name / Synchronize ChangesInspect or change the Git branch, or synchronize with the remote. Synchronizing can pull and push changes; inspect the repository state first.
No Problems / problem countsOpen the editor’s reported diagnostics.
Forwarded PortsInspect exposed development services. These addresses are not the published frontend address.
Notifications / keyboard layoutRead editor notifications or inspect the keyboard-layout setting.

The editor’s own chat panel

A code-server installation can show an additional provider chat panel inside the editor. Rumata’s factory assistant remains in the main workspace conversation.

ControlWhat it does
Toggle Chat / New Chat / Hide Secondary Side BarShow, start, or hide a conversation in the embedded editor’s chat interface.
Open Customizations / Views and More ActionsInspect the editor chat’s available customization and layout commands.
Add Context / Set Agent / Models / Configure ToolsConfigure the editor chat’s context, mode, provider model, and tools. Provider sign-in may be required.
Session Target / Permission picker / SendChoose where the editor agent works, review its permissions, and submit its request. Sending can start work in the same files used by Rumata.

Rumata’s compact file browser

The compact browser appears in read-only frontend source and activity code screens. Editing controls are available only in editable contexts such as an activity draft.

ControlWhat it does
Files / Content / search fieldSearch filenames or file contents. Selecting a result opens its file.
Folder row / chevronExpand or collapse a directory.
Explorer toggle / resize dividerHide or show the file list, or change its width.
File tab / X / middle-clickSelect an open file or close its tab. Closing a tab is not a file deletion.
Modified dotIdentify a file with pending editor changes.
Save Changes / Discard Changes in an editable activity draftApply or discard the current file’s edits in that draft. Creating or publishing the activity is a separate step.

Further reading