Open or create a project

Every Desktop window has one active project. The project contains your source and configuration and determines where files are stored.

Choose a project type

Local folder

Select Open folder in the installed application to work directly with a directory on your computer. Use a local folder for:

• an existing repository;
• offline work;
• large datasets already stored locally;
• source that must remain on the machine.

RunMat can access the folder you select. File operations and relative paths stay within that project. Use Git or your normal backup system to preserve its history.

Cloud project

Sign in and select New project to create a project in an organization. Cloud projects provide shared storage, synchronization across devices, file history, snapshots, and team access.

Cloud project code still runs on your machine by default. Select a configured remote target when a particular job needs additional compute capacity.

Browser project

A browser project stores its files through the browser. It is useful for trying RunMat without installing the application. Browser storage can be cleared by browser or device policy, so download important files or move the project to cloud storage.

Work with project files

Use the Files sidebar to create, open, rename, move, and delete files and folders. The editor marks files with unsaved changes. Save those changes before running code when the run should use the latest source.

RunMat supports MATLAB-style project layouts, including functions in separate .m files, package directories such as +controls, class folders, private functions, and additional source roots declared in runmat.toml.

Configure the project

Use runmat.toml for settings that belong with the source, including:

• source roots and entrypoints;
• package dependencies;
• compatibility behavior;
• Runtime options shared by Desktop, CLI, CI, and remote workers.

Desktop preferences such as theme and panel placement stay with the application.

Move local work to the cloud

When Move to cloud is available, select the destination organization and review the files that will be uploaded. Desktop creates a cloud project from the local folder. The original folder remains on your computer.

After conversion, open the cloud project, confirm the expected files are present, and run the project entrypoint. Keep the local folder until that check is complete.

Switch projects

Open the project menu to choose another project. Each project has its own files, workspace, figures, and run history. Desktop may ask you to resolve unsaved editor changes before switching.

If a local folder has moved or its permission has expired, select it again with Open folder. For a missing cloud project, confirm the active organization and your project access.