Projects, search and undo

How CLEM keeps your flows, and the tools to find them again: projects, notes, tags, search across every flow, and undo for every change.

The workspace

Everything lives in one folder, the workspace. Projects are folders in it, and flows are .clem.json files in a project. A project also holds its environments.json, secrets.json (names only), and the files folder its requests upload from. Flows without a project are kept apart and share their own environments.

SystemDefault workspace
Windows%APPDATA%\clem-electron\workspace
macOS~/Library/Application Support/clem-electron/workspace
Linux~/.config/clem-electron/workspace

Settings → Workspace moves it (for example into a git repository) and Open shows it. Because a project is a plain folder, you can share it, version it or copy it to another computer; secret values stay behind.

Saving and loading

The Load Flow dialog: projects on the left, the flows of the selected project with their tags
Load Flow, with the tag filter over the list.

When a flow's file changes outside CLEM (by git, an editor or an AI client), CLEM reloads it; with unsaved changes it asks whether to reload, keep yours or save yours under another name.

Notes

Notes holds a description of the flow: what it tests, what it needs, who to ask. Notes are saved with the flow and shown at the top of every run log.

Tags

Tags are short labels on a flow, such as smoke, auth or slow. Add them in Flow Settings → Tags: type one and press Enter (or a comma); × removes one. Tags are lower case and use letters, digits, -, _ and .; the field suggests the tags your other flows use.

Ctrl+Shift+F (or the search field of Load Flow) searches every flow of the workspace: names, tags, notes, variables, Functions and every step's URLs, headers, bodies, code, checks and requests in code.

Undo and redo

Ctrl+Z undoes your last change to the flow and Ctrl+Y (or Ctrl+Shift+Z) redoes it. The ↶ / ↷ buttons next to the flow's name do the same; their tooltips say what they will undo or redo.