Save and Open Scripts
Use the same main editor for standalone files and vault scripts. New, Open, and Save offer both storage types.
Press Ctrl+S to save the current script and Alt+S to open a new session. Alt+Shift+S opens Save as. Older screenshots below may show the previous shortcut hints.

| Action | Standalone script | Vault script |
|---|---|---|
| New | Start an unsaved file-based draft. | Start a vault draft with Script settings. |
| Open | Browse for a .pdmshell file. |
Filter and select a script stored in the connected vault. |
| Save | Update the current file, or choose a path for a new file. | Explicitly publish code, visual layout and settings to the vault. |
| Save as… | Write a standalone copy without vault settings. | Create and save a new vault copy immediately. |
Create and open
Use New > Standalone script or New > Vault script. Both start in the visual editor. Switch to code view when you want to type or paste command text.

Use Open > Standalone script… to browse for a file, or Open > Vault script… to use the vault picker. Recent scripts and the online script library remain in the Open menu.

Vault script management requires a vault login and the PDM Edit add-ins permission. See Vault scripts and Script settings for configuration and deletion.
Import or export several vault scripts
Open Open > Vault script… and choose Import… or Export….
- Export: check the scripts to include, choose Export, and save the
.pdmshellscriptsfile. - Import: open a
.pdmshellscriptsor compatible.jsonfile, check the scripts to add, and choose Import.
The bundle keeps each script's code, visual layout, and vault settings. Import adds copies; it does not overwrite existing scripts. Matching names receive a suffix such as (2).
Review imported triggers, conditions, and access settings for the destination vault. Restart PDM Explorer to pick up changed menus and triggers. Importing does not run the scripts.
Standalone files
Visual scripts use the .pdmshell extension. A saved file stores command text and visual workflow layout, including action positions, custom names, and layout inside branches. Older text-only .pdmshell files can still be opened.
Save updates the current file. Save as standalone script… writes a copy to a chosen path. Exporting a vault draft as a standalone file does not include its name, event triggers, conditions or access settings.
Keep box positions and custom names
Arrange the boxes and give them meaningful visual names, then save the script. Switching between script and visual views preserves the positions and names of existing boxes. Saving and reopening a .pdmshell file restores them, including boxes inside branches.
- Double-click an action to edit its visual name. This label describes the step; it does not rename the command or change what it runs.
- Save after changing names or moving boxes so those changes are available when you reopen the script.
- Copying only the command text does not copy visual names or positions. Share the saved
.pdmshellfile, or export the vault script, to keep the layout.
Older text-only files still open, but they have no saved visual layout to restore. Newly added commands receive an initial layout that you can adjust.
Vault drafts
Vault script settings appear to the right of the visual editor. Use the Script settings gear to show or hide the panel.

Changes stay in the draft until Save. Vault scripts are not automatically saved. Save as vault script… does not publish immediately: it creates a new draft for you to name and review, then save.
The document heading identifies the vault. Reconnect to that same vault if you changed sessions before saving. If the saved script changed since it was opened, PDMShell keeps your draft and asks you to reopen the current version or save a new script.

Unsaved changes
New/Open and closing a session tab or PDMShell prompt about unsaved changes. Choose Save, discard, or Cancel. A failed or cancelled save leaves the draft open.
Running a draft and saving it are separate actions. Run can modify real files and vault data before you save. Stopping does not undo completed operations.
AI drafts and comments
Use draft… in the AI pane confirms replacing the code, reveals the editor and expands its code area. It does not execute or save the draft. For a vault document, the existing vault settings remain attached.
Full lines beginning with #, including indented comment lines, are ignored as commands and preserved when editing the workflow. A # inside a command value is not treated as a full-line comment.

Script library
The online Script Library remains available from Open. Downloading a script does not execute it. Save the resulting editor document as a standalone file, or use Save as vault script… to create and save a vault copy. Save again after making further edits.
Screenshots show application controls with sample data.