From 1be24611772e3e172b3fe21d3af42142c56aa19c Mon Sep 17 00:00:00 2001
From: lyx-tec <lyx.tec@gmail.com>
Date: Sun, 19 Jul 2026 17:46:54 +0800
Subject: [PATCH] feat: per-workspace script management system
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add a script management system that lets users store, edit, and execute
shell scripts within a workspace context.

Key features:
- Scripts stored in workspace.meta['scripts:list'] (typed WorkspaceScript[])
- Script execution via heredoc → mktemp → source → rm pipeline,
  supporting bash/zsh/sh/dash (POSIX '.' dot command), with block on
  fish, cmd, and PowerShell
- Script Picker modal (Ctrl+Shift+e or right-click 'Run Script…') with
  search, keyboard navigation, inline delete, and '+ Add Script' entry
- Script Management modal with inline CRUD (edit-in-place, add-at-bottom)
- Workspace editor preview card showing first script with live WOS atom
- blockId explicitly threaded through right-click → picker → runScript
- Go-side MetaTSType registration for 'scripts:list' with auto-generated
  TypeScript types
---
 frontend/app/modals/modalregistry.tsx         |   4 +
 .../app/modals/workspace-scripts-modal.scss   | 278 ++++++++++++++++++
 .../app/modals/workspace-scripts-modal.tsx    | 224 ++++++++++++++
 .../app/modals/workspace-scripts-picker.scss  | 164 +++++++++++
 .../app/modals/workspace-scripts-picker.tsx   | 173 +++++++++++
 frontend/app/store/keymodel.ts                |   4 +
 frontend/app/tab/workspaceeditor.scss         |  15 +
 frontend/app/tab/workspaceeditor.tsx          |  24 ++
 frontend/app/tab/workspaceswitcherdetail.tsx  |   1 +
 frontend/app/view/term/term-model.ts          |  12 +-
 frontend/app/view/term/term.tsx               |   4 +-
 frontend/app/workspace/workspace-scripts.ts   | 120 ++++++++
 frontend/types/gotypes.d.ts                   |  10 +
 pkg/waveobj/metaconsts.go                     |   2 +
 pkg/waveobj/wtype.go                          |  10 +
 pkg/waveobj/wtypemeta.go                      |   5 +-
 16 files changed, 1045 insertions(+), 5 deletions(-)
 create mode 100644 frontend/app/modals/workspace-scripts-modal.scss
 create mode 100644 frontend/app/modals/workspace-scripts-modal.tsx
 create mode 100644 frontend/app/modals/workspace-scripts-picker.scss
 create mode 100644 frontend/app/modals/workspace-scripts-picker.tsx
 create mode 100644 frontend/app/workspace/workspace-scripts.ts

diff --git a/frontend/app/modals/modalregistry.tsx b/frontend/app/modals/modalregistry.tsx
index ec583b4cbe..cf1330af09 100644
--- a/frontend/app/modals/modalregistry.tsx
+++ b/frontend/app/modals/modalregistry.tsx
@@ -10,6 +10,8 @@ import { SetSecretDialog } from "@/builder/tabs/builder-secrettab";
 import { AboutModal } from "./about";
 import { ConfirmModal } from "./confirmmodal";
 import { UserInputModal } from "./userinputmodal";
+import { WorkspaceScriptsModal } from "./workspace-scripts-modal";
+import { WorkspaceScriptsPicker } from "./workspace-scripts-picker";
 
 const modalRegistry: { [key: string]: React.ComponentType<any> } = {
     [NewInstallOnboardingModal.displayName || "NewInstallOnboardingModal"]: NewInstallOnboardingModal,
@@ -23,6 +25,8 @@ const modalRegistry: { [key: string]: React.ComponentType<any> } = {
     [RenameFileModal.displayName || "RenameFileModal"]: RenameFileModal,
     [DeleteFileModal.displayName || "DeleteFileModal"]: DeleteFileModal,
     [SetSecretDialog.displayName || "SetSecretDialog"]: SetSecretDialog,
+    [WorkspaceScriptsPicker.displayName || "WorkspaceScriptsPicker"]: WorkspaceScriptsPicker,
+    [WorkspaceScriptsModal.displayName || "WorkspaceScriptsModal"]: WorkspaceScriptsModal,
 };
 
 export const getModalComponent = (key: string): React.ComponentType<any> | undefined => {
diff --git a/frontend/app/modals/workspace-scripts-modal.scss b/frontend/app/modals/workspace-scripts-modal.scss
new file mode 100644
index 0000000000..47af847f9a
--- /dev/null
+++ b/frontend/app/modals/workspace-scripts-modal.scss
@@ -0,0 +1,278 @@
+// Copyright 2026, Command Line Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+.workspace-scripts-modal {
+    width: 520px;
+    max-height: 70vh;
+    display: flex;
+    flex-direction: column;
+    padding: 16px 0 12px;
+    gap: 0;
+
+    .scripts-modal-root {
+        display: flex;
+        flex-direction: column;
+        flex: 1;
+        min-height: 0;
+        width: 100%;
+        outline: none;
+    }
+
+    .scripts-modal-header {
+        font-size: 14px;
+        font-weight: 600;
+        color: var(--main-text-color);
+        padding: 0 20px 12px;
+        user-select: none;
+        display: flex;
+        align-items: center;
+        gap: 8px;
+
+        &::before {
+            content: "\f085";
+            font-family: "Font Awesome 6 Sharp", "Font Awesome 6 Free", "Font Awesome 5 Free", sans-serif;
+            font-weight: 900;
+            font-size: 12px;
+            color: var(--accent-color);
+        }
+    }
+
+    .scripts-modal-body {
+        flex: 1;
+        min-height: 0;
+        overflow-y: auto;
+        padding: 0 20px;
+    }
+
+    .modal-loading {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        padding: 32px;
+        color: var(--secondary-text-color);
+    }
+
+    .scripts-empty-state {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        padding: 44px 20px;
+        gap: 10px;
+
+        .scripts-empty-icon {
+            font-size: 32px;
+            color: var(--secondary-text-color);
+            opacity: 0.25;
+        }
+
+        .scripts-empty-text {
+            font-size: 14px;
+            font-weight: 500;
+            color: var(--main-text-color);
+            margin-top: 2px;
+        }
+
+        .scripts-empty-subtext {
+            font-size: 12px;
+            color: var(--secondary-text-color);
+            text-align: center;
+            line-height: 1.5;
+        }
+    }
+
+    .scripts-list {
+        display: flex;
+        flex-direction: column;
+        gap: 10px;
+        padding: 4px 0;
+    }
+
+    .script-item {
+        border: 1px solid var(--modal-border-color);
+        border-radius: 6px;
+        padding: 10px 12px;
+        background: var(--modal-bg-color);
+        transition: border-color 0.15s, box-shadow 0.15s;
+        position: relative;
+
+        &:hover {
+            border-color: rgb(from var(--accent-color) r g b / 0.3);
+            box-shadow: 0 1px 4px rgba(0, 0, 0, 0.3);
+        }
+
+        .script-item-header {
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+        }
+
+        .script-item-name {
+            font-size: 13px;
+            font-weight: 600;
+            color: var(--main-text-color);
+        }
+
+        .script-item-actions {
+            display: flex;
+            gap: 2px;
+            opacity: 0;
+            transition: opacity 0.12s;
+        }
+
+        &:hover .script-item-actions {
+            opacity: 1;
+        }
+
+        .script-action-btn {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            width: 26px;
+            height: 26px;
+            border: none;
+            border-radius: 4px;
+            background: transparent;
+            color: var(--secondary-text-color);
+            cursor: pointer;
+            font-size: 12px;
+            transition: background-color 0.12s, color 0.12s;
+
+            &:hover {
+                background-color: var(--highlight-bg-color);
+                color: var(--main-text-color);
+            }
+
+            &.delete:hover {
+                color: var(--error-color);
+                background-color: rgb(from var(--error-color) r g b / 0.12);
+            }
+        }
+
+        .script-item-desc {
+            font-size: 11px;
+            color: var(--secondary-text-color);
+            opacity: 0.7;
+            margin-top: 6px;
+            white-space: nowrap;
+            overflow: hidden;
+            text-overflow: ellipsis;
+            max-width: 100%;
+        }
+
+        .script-item-command {
+            font-size: 11px;
+            color: var(--secondary-text-color);
+            font-family: var(--termfontfamily);
+            margin-top: 5px;
+            white-space: nowrap;
+            overflow: hidden;
+            text-overflow: ellipsis;
+            max-width: 100%;
+        }
+    }
+
+    // Left accent bar signals "this is the editing area" without creating a
+    // double-frame effect when the inner input/textarea is focused.
+    .script-edit-form {
+        border: 1px solid var(--modal-border-color);
+        border-left: 3px solid var(--accent-color);
+        border-radius: 6px;
+        padding: 12px 12px 12px 10px;
+        display: flex;
+        flex-direction: column;
+        gap: 10px;
+    }
+
+    .script-form-field {
+        display: flex;
+        flex-direction: column;
+        gap: 4px;
+
+        label {
+            font-size: 12px;
+            font-weight: 500;
+            color: var(--main-text-color);
+            user-select: none;
+        }
+
+        .input {
+            font-size: 13px;
+            padding: 7px 10px;
+            background: var(--form-element-bg-color);
+            border-color: var(--form-element-border-color);
+
+            &:focus-within {
+                border-color: var(--accent-color);
+            }
+        }
+    }
+
+    .form-field-grow {
+        flex: 1;
+        min-height: 0;
+        display: flex;
+        flex-direction: column;
+
+        textarea {
+            flex: 1;
+            min-height: 80px;
+        }
+    }
+
+    textarea {
+        width: 100%;
+        font-size: 12px;
+        padding: 7px 10px;
+        border: 1px solid var(--form-element-border-color);
+        border-radius: 4px;
+        background: var(--form-element-bg-color);
+        color: var(--main-text-color);
+        resize: vertical;
+        line-height: 1.5;
+        transition: border-color 0.15s;
+
+        &:focus {
+            outline: none;
+            border-color: var(--accent-color);
+        }
+
+        &::placeholder {
+            color: var(--secondary-text-color);
+            opacity: 0.5;
+        }
+    }
+
+    .script-command-textarea {
+        font-family: var(--termfontfamily);
+        min-height: 72px;
+    }
+
+    .script-desc-textarea {
+        font-family: var(--base-font);
+        min-height: 40px;
+    }
+
+    .script-form-error {
+        font-size: 12px;
+        color: var(--error-color);
+        padding: 6px 8px;
+        background: rgb(from var(--error-color) r g b / 0.08);
+        border-radius: 4px;
+    }
+
+    .script-form-actions {
+        display: flex;
+        justify-content: flex-end;
+        gap: 8px;
+        padding-top: 2px;
+    }
+
+    .scripts-modal-footer {
+        display: flex;
+        justify-content: center;
+        padding: 12px 20px 0;
+        border-top: 1px solid var(--modal-border-color);
+        margin: 0 20px;
+    }
+}
diff --git a/frontend/app/modals/workspace-scripts-modal.tsx b/frontend/app/modals/workspace-scripts-modal.tsx
new file mode 100644
index 0000000000..18689bab6c
--- /dev/null
+++ b/frontend/app/modals/workspace-scripts-modal.tsx
@@ -0,0 +1,224 @@
+// Copyright 2026, Command Line Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+import { Button } from "@/app/element/button";
+import { Input } from "@/app/element/input";
+import { modalsModel } from "@/app/store/modalmodel";
+import { WOS } from "@/app/store/global";
+import {
+    getScriptsFromWorkspace,
+    saveScriptsToWorkspace,
+} from "@/app/workspace/workspace-scripts";
+import { Modal } from "./modal";
+import "./workspace-scripts-modal.scss";
+import { memo, useCallback, useState } from "react";
+
+interface WorkspaceScriptsModalProps {
+    workspaceId: string;
+}
+
+const WorkspaceScriptsModalComponent = ({ workspaceId }: WorkspaceScriptsModalProps) => {
+    const [workspace] = WOS.useWaveObjectValue<Workspace>(WOS.makeORef("workspace", workspaceId));
+    const [editingId, setEditingId] = useState<string | null>(null);
+    const [showAddForm, setShowAddForm] = useState(false);
+    const [draftName, setDraftName] = useState("");
+    const [draftCommand, setDraftCommand] = useState("");
+    const [draftDesc, setDraftDesc] = useState("");
+    const [errorMsg, setErrorMsg] = useState("");
+
+    const scripts = getScriptsFromWorkspace(workspace);
+    const isEditing = editingId != null || showAddForm;
+
+    const resetForm = useCallback(() => {
+        setDraftName("");
+        setDraftCommand("");
+        setDraftDesc("");
+        setEditingId(null);
+        setShowAddForm(false);
+        setErrorMsg("");
+    }, []);
+
+    const startEdit = useCallback((script: WorkspaceScript) => {
+        setEditingId(script.id);
+        setDraftName(script.name);
+        setDraftCommand(script.command);
+        setDraftDesc(script.desc ?? "");
+        setErrorMsg("");
+    }, []);
+
+    const startAdd = useCallback(() => {
+        resetForm();
+        setShowAddForm(true);
+    }, [resetForm]);
+
+    const validateForm = useCallback((): string | null => {
+        const name = draftName.trim();
+        if (!name) return "Script name is required";
+        const command = draftCommand.trim();
+        if (!command) return "Command is required";
+        const isDup = scripts.some((s) => s.name === name && s.id !== editingId);
+        if (isDup) return `A script named "${name}" already exists`;
+        return null;
+    }, [draftName, draftCommand, scripts, editingId]);
+
+    const handleSave = useCallback(() => {
+        const err = validateForm();
+        if (err) {
+            setErrorMsg(err);
+            return;
+        }
+        setErrorMsg("");
+        if (editingId) {
+            const updated = scripts.map((s) =>
+                s.id === editingId
+                    ? { ...s, name: draftName.trim(), command: draftCommand.trim(), desc: draftDesc.trim() || undefined }
+                    : s
+            );
+            saveScriptsToWorkspace(workspaceId, updated);
+        } else {
+            const newScript: WorkspaceScript = {
+                id: crypto.randomUUID(),
+                name: draftName.trim(),
+                command: draftCommand.trim(),
+                desc: draftDesc.trim() || undefined,
+            };
+            saveScriptsToWorkspace(workspaceId, [...scripts, newScript]);
+        }
+        resetForm();
+    }, [editingId, draftName, draftCommand, draftDesc, scripts, workspaceId, validateForm, resetForm]);
+
+    const handleDelete = useCallback(
+        (script: WorkspaceScript) => {
+            modalsModel.pushModal("ConfirmModal", {
+                message: `Delete script "${script.name}"?\nThis action cannot be undone.`,
+                onOk: () => {
+                    const updated = scripts.filter((s) => s.id !== script.id);
+                    saveScriptsToWorkspace(workspaceId, updated);
+                },
+            });
+        },
+        [scripts, workspaceId]
+    );
+
+    // Handle Escape locally so the global modal-pop handler doesn't also fire.
+    // While editing, Escape only cancels the form; otherwise it closes the modal.
+    const handleKeyDown = useCallback(
+        (e: React.KeyboardEvent) => {
+            if (e.key !== "Escape") return;
+            e.preventDefault();
+            e.stopPropagation();
+            if (isEditing) {
+                resetForm();
+            } else {
+                modalsModel.popModal();
+            }
+        },
+        [isEditing, resetForm]
+    );
+
+    if (!workspace) {
+        return (
+            <Modal className="workspace-scripts-modal" onClose={() => modalsModel.popModal()}>
+                <div className="modal-loading">Loading...</div>
+            </Modal>
+        );
+    }
+
+    const renderForm = (submitLabel: string, growCommand?: boolean) => (
+        <div className="script-edit-form">
+            <div className="script-form-field">
+                <label>Name</label>
+                <Input value={draftName} onChange={setDraftName} placeholder="Script name" autoFocus />
+            </div>
+            <div className={`script-form-field ${growCommand ? "form-field-grow" : ""}`}>
+                <label>Command</label>
+                <textarea
+                    className="script-command-textarea"
+                    value={draftCommand}
+                    onChange={(e) => setDraftCommand(e.target.value)}
+                    placeholder="Shell commands (one per line)"
+                    rows={growCommand ? undefined : 4}
+                />
+            </div>
+            <div className="script-form-field">
+                <label>Description (optional)</label>
+                <textarea
+                    className="script-desc-textarea"
+                    value={draftDesc}
+                    onChange={(e) => setDraftDesc(e.target.value)}
+                    placeholder="What this script does"
+                    rows={2}
+                />
+            </div>
+            {errorMsg && <div className="script-form-error">{errorMsg}</div>}
+            <div className="script-form-actions">
+                <Button className="grey ghost" onClick={resetForm}>
+                    Cancel
+                </Button>
+                <Button onClick={handleSave}>{submitLabel}</Button>
+            </div>
+        </div>
+    );
+
+    return (
+        <Modal className="workspace-scripts-modal" onClose={() => modalsModel.popModal()}>
+            <div className="scripts-modal-root" onKeyDown={handleKeyDown}>
+                <div className="scripts-modal-header">Workspace Scripts</div>
+                <div className="scripts-modal-body">
+                    {scripts.length === 0 && !showAddForm ? (
+                        <div className="scripts-empty-state">
+                            <div className="scripts-empty-icon">
+                                <i className="fa-sharp fa-regular fa-scroll"></i>
+                            </div>
+                            <div className="scripts-empty-text">No scripts yet</div>
+                            <div className="scripts-empty-subtext">
+                                Save your frequently used commands to quickly invoke them later.
+                            </div>
+                        </div>
+                    ) : (
+                        <div className="scripts-list">
+                            {scripts.map((script) =>
+                                editingId === script.id ? (
+                                    <div key={script.id}>{renderForm("Save", false)}</div>
+                                ) : (
+                                    <div key={script.id} className="script-item">
+                                        <div className="script-item-header">
+                                            <div className="script-item-name">{script.name}</div>
+                                            <div className="script-item-actions">
+                                                <button
+                                                    className="script-action-btn edit"
+                                                    onClick={() => startEdit(script)}
+                                                    title="Edit script"
+                                                >
+                                                    <i className="fa-sharp fa-solid fa-pencil"></i>
+                                                </button>
+                                                <button
+                                                    className="script-action-btn delete"
+                                                    onClick={() => handleDelete(script)}
+                                                    title="Delete script"
+                                                >
+                                                    <i className="fa-sharp fa-solid fa-trash"></i>
+                                                </button>
+                                            </div>
+                                        </div>
+                                        <div className="script-item-command">{script.command}</div>
+                                        {script.desc && <div className="script-item-desc">{script.desc}</div>}
+                                    </div>
+                                )
+                            )}
+                            {showAddForm && renderForm("Add Script", false)}
+                        </div>
+                    )}
+                </div>
+                {!isEditing && (
+                    <div className="scripts-modal-footer">
+                        <Button onClick={startAdd}>+ Add Script</Button>
+                    </div>
+                )}
+            </div>
+        </Modal>
+    );
+};
+
+export const WorkspaceScriptsModal = memo(WorkspaceScriptsModalComponent);
+WorkspaceScriptsModal.displayName = "WorkspaceScriptsModal";
diff --git a/frontend/app/modals/workspace-scripts-picker.scss b/frontend/app/modals/workspace-scripts-picker.scss
new file mode 100644
index 0000000000..2098484ad4
--- /dev/null
+++ b/frontend/app/modals/workspace-scripts-picker.scss
@@ -0,0 +1,164 @@
+// Copyright 2026, Command Line Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+.workspace-scripts-picker {
+    width: 480px;
+    max-height: 70vh;
+    display: flex;
+    flex-direction: column;
+    padding: 16px 0 12px;
+    gap: 0;
+
+    .picker-root {
+        display: flex;
+        flex-direction: column;
+        flex: 1;
+        min-height: 0;
+        width: 100%;
+        outline: none;
+    }
+
+    .picker-header {
+        font-size: 14px;
+        font-weight: 600;
+        color: var(--main-text-color);
+        padding: 0 20px 12px;
+        user-select: none;
+        display: flex;
+        align-items: center;
+        gap: 8px;
+
+        &::before {
+            content: "\f120";
+            font-family: "Font Awesome 6 Sharp", "Font Awesome 6 Free", "Font Awesome 5 Free", sans-serif;
+            font-weight: 900;
+            font-size: 12px;
+            color: var(--accent-color);
+        }
+    }
+
+    .picker-search {
+        padding: 0 20px 10px;
+
+        .input-group {
+            width: 100%;
+
+            .input {
+                width: 100%;
+                font-size: 13px;
+                padding: 7px 10px 7px 32px;
+                background: var(--form-element-bg-color);
+                border-color: var(--form-element-border-color);
+                transition: border-color 0.15s;
+
+                &:focus-within {
+                    border-color: var(--accent-color);
+                }
+            }
+        }
+
+        .input-left-element {
+            left: 10px;
+            font-size: 13px;
+            color: var(--secondary-text-color);
+            opacity: 0.5;
+            pointer-events: none;
+        }
+    }
+
+    .picker-list-wrapper {
+        flex: 1;
+        min-height: 0;
+        overflow-y: auto;
+        background: var(--modal-bg-color);
+        border-top: 1px solid var(--modal-border-color);
+        border-bottom: 1px solid var(--modal-border-color);
+    }
+
+    .picker-empty {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        gap: 8px;
+        padding: 36px 20px;
+        color: var(--secondary-text-color);
+        font-size: 13px;
+        user-select: none;
+
+        i {
+            font-size: 24px;
+            opacity: 0.25;
+        }
+
+        .button {
+            margin-top: 4px;
+        }
+    }
+
+    .picker-list {
+        display: flex;
+        flex-direction: column;
+        padding: 4px 0;
+    }
+
+    .picker-item {
+        padding: 9px 20px 9px 16px;
+        cursor: pointer;
+        border-left: 3px solid transparent;
+        border-bottom: 1px solid var(--modal-border-color);
+        transition: background-color 0.12s, border-color 0.12s;
+        position: relative;
+
+        &:last-child {
+            border-bottom: none;
+        }
+
+        &:hover {
+            background-color: var(--highlight-bg-color);
+        }
+
+        &.selected {
+            background-color: rgb(from var(--accent-color) r g b / 0.15);
+            border-left-color: var(--accent-color);
+        }
+    }
+
+    .picker-item-name {
+        font-size: 13px;
+        font-weight: 600;
+        color: var(--main-text-color);
+        user-select: none;
+    }
+
+    .picker-item-desc {
+        font-size: 11px;
+        color: var(--secondary-text-color);
+        opacity: 0.7;
+        user-select: none;
+        margin-top: 3px;
+        white-space: nowrap;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        max-width: 100%;
+    }
+
+    .picker-item-time {
+        position: absolute;
+        top: 9px;
+        right: 20px;
+        font-size: 10px;
+        color: var(--secondary-text-color);
+        opacity: 0.5;
+        user-select: none;
+        background: rgba(255, 255, 255, 0.06);
+        border-radius: 3px;
+        padding: 1px 5px;
+    }
+
+    .picker-footer {
+        display: flex;
+        justify-content: flex-end;
+        padding: 10px 20px 0;
+    }
+}
diff --git a/frontend/app/modals/workspace-scripts-picker.tsx b/frontend/app/modals/workspace-scripts-picker.tsx
new file mode 100644
index 0000000000..75e707ab44
--- /dev/null
+++ b/frontend/app/modals/workspace-scripts-picker.tsx
@@ -0,0 +1,173 @@
+// Copyright 2026, Command Line Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+import { getScriptsFromWorkspace, getSortedScripts, runScript } from "@/app/workspace/workspace-scripts";
+import { Button } from "@/app/element/button";
+import { Input, InputGroup, InputLeftElement } from "@/app/element/input";
+import { modalsModel } from "@/app/store/modalmodel";
+import { WOS } from "@/app/store/global";
+import { formatRelativeTime } from "@/util/util";
+import clsx from "clsx";
+import { memo, useCallback, useEffect, useRef, useState } from "react";
+import { Modal } from "./modal";
+import "./workspace-scripts-picker.scss";
+
+interface ScriptPickerProps {
+    workspaceId: string;
+    blockId?: string;
+}
+
+const WorkspaceScriptsPickerComponent = ({ workspaceId, blockId }: ScriptPickerProps) => {
+    const [workspace] = WOS.useWaveObjectValue<Workspace>(WOS.makeORef("workspace", workspaceId));
+    const [searchText, setSearchText] = useState("");
+    const [selectedIndex, setSelectedIndex] = useState(-1);
+    const searchInputRef = useRef<HTMLInputElement>(null);
+    const listRef = useRef<HTMLDivElement>(null);
+
+    const scripts = getSortedScripts(getScriptsFromWorkspace(workspace));
+    const filtered = scripts.filter((s) => {
+        if (!searchText) return true;
+        const q = searchText.toLowerCase();
+        return s.name.toLowerCase().includes(q) || s.command.toLowerCase().includes(q);
+    });
+
+    const handleRun = useCallback((script: WorkspaceScript) => {
+        const result = runScript(script, blockId);
+        if (!result.ok) {
+            modalsModel.pushModal("MessageModal", { children: result.reason ?? "Failed to run script." });
+            return;
+        }
+        modalsModel.popModal();
+    }, [blockId]);
+
+    const handleManage = useCallback(() => {
+        modalsModel.popModal();
+        modalsModel.pushModal("WorkspaceScriptsModal", { workspaceId });
+    }, [workspaceId]);
+
+    // Reset selection whenever the filter changes
+    useEffect(() => {
+        setSelectedIndex(-1);
+    }, [searchText]);
+
+    // Scroll selected item into view
+    useEffect(() => {
+        if (selectedIndex < 0 || !listRef.current) return;
+        const item = listRef.current.children[selectedIndex] as HTMLElement;
+        item?.scrollIntoView({ block: "nearest" });
+    }, [selectedIndex]);
+
+    const handleKeyDown = useCallback(
+        (e: React.KeyboardEvent) => {
+            if (e.key === "ArrowDown") {
+                e.preventDefault();
+                e.stopPropagation();
+                if (filtered.length > 0) {
+                    setSelectedIndex((prev) => Math.min(prev + 1, filtered.length - 1));
+                }
+            } else if (e.key === "ArrowUp") {
+                e.preventDefault();
+                e.stopPropagation();
+                setSelectedIndex((prev) => {
+                    if (prev <= 0) {
+                        searchInputRef.current?.focus();
+                        return -1;
+                    }
+                    return prev - 1;
+                });
+            } else if (e.key === "Enter") {
+                e.preventDefault();
+                e.stopPropagation();
+                const idx = selectedIndex >= 0 ? selectedIndex : 0;
+                if (idx < filtered.length) {
+                    handleRun(filtered[idx]);
+                }
+            } else if (e.key === "Escape") {
+                e.preventDefault();
+                e.stopPropagation();
+                modalsModel.popModal();
+            }
+        },
+        [filtered, selectedIndex, handleRun]
+    );
+
+    if (!workspace) {
+        return (
+            <Modal className="workspace-scripts-picker" onClose={() => modalsModel.popModal()}>
+                <div className="picker-empty">Loading...</div>
+            </Modal>
+        );
+    }
+
+    return (
+        <Modal className="workspace-scripts-picker" onClose={() => modalsModel.popModal()}>
+            <div className="picker-root" onKeyDown={handleKeyDown}>
+                <div className="picker-header">Run Script</div>
+                <div className="picker-search">
+                    <InputGroup>
+                        <InputLeftElement>
+                            <i className="fa-sharp fa-solid fa-magnifying-glass"></i>
+                        </InputLeftElement>
+                        <Input
+                            ref={searchInputRef}
+                            placeholder="Search scripts..."
+                            value={searchText}
+                            onChange={setSearchText}
+                            autoFocus
+                        />
+                    </InputGroup>
+                </div>
+                <div className="picker-list-wrapper">
+                    {filtered.length === 0 ? (
+                        <div className="picker-empty">
+                            {scripts.length === 0 ? (
+                                <>
+                                    <i className="fa-sharp fa-regular fa-scroll"></i>
+                                    <span>No scripts configured</span>
+                                    <Button
+                                        className="ghost grey"
+                                        onClick={() => {
+                                            modalsModel.popModal();
+                                            modalsModel.pushModal("WorkspaceScriptsModal", { workspaceId });
+                                        }}
+                                    >
+                                        + Add Script
+                                    </Button>
+                                </>
+                            ) : (
+                                "No matching scripts"
+                            )}
+                        </div>
+                    ) : (
+                        <div className="picker-list" ref={listRef} role="listbox">
+                            {filtered.map((script, index) => (
+                                <div
+                                    key={script.id}
+                                    className={clsx("picker-item", { selected: index === selectedIndex })}
+                                    role="option"
+                                    aria-selected={index === selectedIndex}
+                                    onMouseEnter={() => setSelectedIndex(index)}
+                                    onClick={() => handleRun(script)}
+                                >
+                                    <div className="picker-item-name">{script.name}</div>
+                                    {script.desc && <div className="picker-item-desc">{script.desc}</div>}
+                                    {script.lastused != null && (
+                                        <div className="picker-item-time">{formatRelativeTime(script.lastused)}</div>
+                                    )}
+                                </div>
+                            ))}
+                        </div>
+                    )}
+                </div>
+                <div className="picker-footer">
+                    <Button className="ghost grey" onClick={handleManage}>
+                        Manage Scripts...
+                    </Button>
+                </div>
+            </div>
+        </Modal>
+    );
+};
+
+export const WorkspaceScriptsPicker = memo(WorkspaceScriptsPickerComponent);
+WorkspaceScriptsPicker.displayName = "WorkspaceScriptsPicker";
diff --git a/frontend/app/store/keymodel.ts b/frontend/app/store/keymodel.ts
index 225b70973f..69737c2b5a 100644
--- a/frontend/app/store/keymodel.ts
+++ b/frontend/app/store/keymodel.ts
@@ -27,6 +27,7 @@ import * as keyutil from "@/util/keyutil";
 import { isWindows } from "@/util/platformutil";
 import { termLog } from "@/util/termlog";
 import { CHORD_TIMEOUT } from "@/util/sharedconst";
+import { openScriptsPicker } from "@/app/workspace/workspace-scripts";
 import { fireAndForget } from "@/util/util";
 import * as jotai from "jotai";
 import { TermViewModel } from "../view/term/term-model";
@@ -664,6 +665,9 @@ function registerGlobalKeys() {
         }
         return false;
     });
+    globalKeyMap.set("Ctrl:Shift:e", () => {
+        return openScriptsPicker();
+    });
     globalKeyMap.set("Cmd:g", () => {
         const bcm = getBlockComponentModel(getFocusedBlockInCurrentTab());
         if (bcm.openSwitchConnection != null) {
diff --git a/frontend/app/tab/workspaceeditor.scss b/frontend/app/tab/workspaceeditor.scss
index 1aa9ee3f54..77015e2e82 100644
--- a/frontend/app/tab/workspaceeditor.scss
+++ b/frontend/app/tab/workspaceeditor.scss
@@ -113,6 +113,21 @@
         margin-top: 10px;
     }
 
+    .scripts-section {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        margin-top: 15px;
+        padding-top: 10px;
+        border-top: 1px solid var(--modal-border-color);
+
+        .scripts-section-label {
+            font-size: 12px;
+            font-weight: 500;
+            color: var(--main-text-color);
+        }
+    }
+
     .icon-selector {
         display: grid;
         grid-template-columns: repeat(auto-fit, minmax(16px, 16px));
diff --git a/frontend/app/tab/workspaceeditor.tsx b/frontend/app/tab/workspaceeditor.tsx
index 270d4024b2..bddd4e200e 100644
--- a/frontend/app/tab/workspaceeditor.tsx
+++ b/frontend/app/tab/workspaceeditor.tsx
@@ -3,7 +3,10 @@ import clsx from "clsx";
 import { memo, useEffect, useRef, useState } from "react";
 import { Button } from "../element/button";
 import { Input } from "../element/input";
+import { modalsModel } from "../store/modalmodel";
 import { WorkspaceService } from "../store/services";
+import * as WOS from "../store/wos";
+import { getScriptsFromWorkspace } from "../workspace/workspace-scripts";
 import { WorkspaceConnectionSelector } from "./workspaceconnectionselector";
 import "./workspaceeditor.scss";
 
@@ -68,6 +71,7 @@ interface WorkspaceEditorProps {
     connName: string;
     cwd: string;
     focusInput: boolean;
+    workspaceId?: string;
     onTitleChange: (newTitle: string) => void;
     onColorChange: (newColor: string) => void;
     onIconChange: (newIcon: string) => void;
@@ -83,6 +87,7 @@ const WorkspaceEditorComponent = ({
     connName,
     cwd,
     focusInput,
+    workspaceId,
     onTitleChange,
     onColorChange,
     onIconChange,
@@ -134,6 +139,7 @@ const WorkspaceEditorComponent = ({
             <Input className="py-[3px]" onChange={onCwdChange} value={cwd} placeholder="Default work directory" />
             <ColorSelector selectedColor={color} colors={colors} onSelect={onColorChange} />
             <IconSelector selectedIcon={icon} icons={icons} onSelect={onIconChange} />
+            {workspaceId && <ScriptsSection workspaceId={workspaceId} />}
             <div className="delete-ws-btn-wrapper">
                 <Button className="ghost red text-[12px] bold" onClick={onDeleteWorkspace}>
                     Delete workspace
@@ -143,4 +149,22 @@ const WorkspaceEditorComponent = ({
     );
 };
 
+const ScriptsSection = memo(({ workspaceId }: { workspaceId: string }) => {
+    const [workspace] = WOS.useWaveObjectValue<Workspace>(WOS.makeORef("workspace", workspaceId));
+    const scripts = getScriptsFromWorkspace(workspace);
+
+    const handleManage = () => {
+        modalsModel.pushModal("WorkspaceScriptsModal", { workspaceId });
+    };
+
+    return (
+        <div className="scripts-section">
+            <span className="scripts-section-label">Scripts ({scripts.length})</span>
+            <Button className="ghost grey text-[12px] bold" onClick={handleManage}>
+                Manage
+            </Button>
+        </div>
+    );
+});
+
 export const WorkspaceEditor = memo(WorkspaceEditorComponent);
diff --git a/frontend/app/tab/workspaceswitcherdetail.tsx b/frontend/app/tab/workspaceswitcherdetail.tsx
index 5b76b8aa8f..19bbfaa587 100644
--- a/frontend/app/tab/workspaceswitcherdetail.tsx
+++ b/frontend/app/tab/workspaceswitcherdetail.tsx
@@ -143,6 +143,7 @@ const WorkspaceSwitcherDetail = ({
                     connName={draft.defaultconnname}
                     cwd={draft.defaultcwd}
                     focusInput
+                    workspaceId={workspace.oid}
                     onTitleChange={(newTitle) => setWorkspaceField({ name: newTitle })}
                     onColorChange={(newColor) => setWorkspaceField({ color: newColor })}
                     onIconChange={(newIcon) => setWorkspaceField({ icon: newIcon })}
diff --git a/frontend/app/view/term/term-model.ts b/frontend/app/view/term/term-model.ts
index 1471eff5b8..23e65bfc1f 100644
--- a/frontend/app/view/term/term-model.ts
+++ b/frontend/app/view/term/term-model.ts
@@ -38,6 +38,7 @@ import * as services from "@/store/services";
 import * as keyutil from "@/util/keyutil";
 import { isMacOS, isWindows } from "@/util/platformutil";
 import { boundNumber, fireAndForget, stringToBase64 } from "@/util/util";
+import { openScriptsPicker } from "@/app/workspace/workspace-scripts";
 import * as jotai from "jotai";
 import * as React from "react";
 import { getBlockingCommand } from "./shellblocking";
@@ -826,7 +827,7 @@ export class TermViewModel implements ViewModel {
         });
     }
 
-    getContextMenuItems(): ContextMenuItem[] {
+    getContextMenuItems(blockId: string): ContextMenuItem[] {
         const menu: ContextMenuItem[] = [];
         const hasSelection = this.termRef.current?.terminal?.hasSelection();
         const selection = hasSelection ? this.termRef.current?.terminal.getSelection() : null;
@@ -902,6 +903,15 @@ export class TermViewModel implements ViewModel {
 
         menu.push({ type: "separator" });
 
+        menu.push({
+            label: "Run Script...",
+            click: () => {
+                openScriptsPicker(blockId);
+            },
+        });
+
+        menu.push({ type: "separator" });
+
         const magnified = globalStore.get(this.nodeModel.isMagnified);
         menu.push({
             label: magnified ? "Un-Magnify Block" : "Magnify Block",
diff --git a/frontend/app/view/term/term.tsx b/frontend/app/view/term/term.tsx
index e8c75f6037..fe0f1c13c5 100644
--- a/frontend/app/view/term/term.tsx
+++ b/frontend/app/view/term/term.tsx
@@ -455,10 +455,10 @@ const TerminalView = ({ blockId, model }: ViewComponentProps<TermViewModel>) =>
         (e: React.MouseEvent<HTMLDivElement>) => {
             e.preventDefault();
             e.stopPropagation();
-            const menuItems = model.getContextMenuItems();
+            const menuItems = model.getContextMenuItems(blockId);
             ContextMenuModel.getInstance().showContextMenu(menuItems, e);
         },
-        [model]
+        [model, blockId]
     );
 
     return (
diff --git a/frontend/app/workspace/workspace-scripts.ts b/frontend/app/workspace/workspace-scripts.ts
new file mode 100644
index 0000000000..5bb6200003
--- /dev/null
+++ b/frontend/app/workspace/workspace-scripts.ts
@@ -0,0 +1,120 @@
+// Copyright 2026, Command Line Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+import { atoms, getBlockMetaKeyAtom, getFocusedBlockId, getOverrideConfigAtom, globalStore, WOS } from "@/app/store/global";
+import { modalsModel } from "@/app/store/modalmodel";
+import { ObjectService } from "@/app/store/services";
+import { RpcApi } from "@/app/store/wshclientapi";
+import { TabRpcClient } from "@/app/store/wshrpcutil";
+import { isWindows } from "@/util/platformutil";
+import { fireAndForget, isLocalConnName, stringToBase64 } from "@/util/util";
+
+const TempFileVar = "__WAVE_SCR_FILE";
+
+const MetaKeyScriptsList = "scripts:list";
+
+/** Open the script picker modal, if the focused block is a terminal.
+ *  Returns true if the modal was opened, false if the condition was not met
+ *  (caller should not swallow the key event). */
+export function openScriptsPicker(blockIdOverride?: string): boolean {
+    const blockId = blockIdOverride ?? getFocusedBlockId();
+    if (blockId == null) return false;
+    const view = globalStore.get(getBlockMetaKeyAtom(blockId, "view"));
+    if (view !== "term") return false;
+    const workspaceId = globalStore.get(atoms.workspaceId);
+    if (!workspaceId) return false;
+    if (modalsModel.isModalOpen("WorkspaceScriptsPicker")) return false;
+    modalsModel.pushModal("WorkspaceScriptsPicker", { workspaceId, blockId });
+    return true;
+}
+
+export function getScriptsFromWorkspace(workspace: Workspace): WorkspaceScript[] {
+    const raw = workspace?.meta?.[MetaKeyScriptsList];
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    return raw.filter(
+        (s: any) => s != null && typeof s.id === "string" && typeof s.name === "string" && typeof s.command === "string"
+    );
+}
+
+export function getSortedScripts(scripts: WorkspaceScript[]): WorkspaceScript[] {
+    return [...scripts].sort((a, b) => (b.lastused ?? 0) - (a.lastused ?? 0));
+}
+
+// Builds the shell text injected into the terminal to run a script.
+// The script body is written to a unique temp file (mktemp) via heredoc, then
+// sourced (using POSIX `.`) in the current shell (so cd/export persist) and
+// always cleaned up.
+function buildHeredocCommand(script: WorkspaceScript): string {
+    const delimiter = `WST_SCRIPT_END_${crypto.randomUUID().replace(/-/g, "").slice(0, 12)}`;
+    const lines = [
+        `${TempFileVar}=$(mktemp "\${TMPDIR:-/tmp}/waveterm-script-XXXXXX"); cat << '${delimiter}' > "$${TempFileVar}"`,
+        script.command,
+        delimiter,
+        `. "$${TempFileVar}"; rm -f "$${TempFileVar}"`,
+    ];
+    return lines.join("\n") + "\n";
+}
+
+export function saveScriptsToWorkspace(workspaceId: string, scripts: WorkspaceScript[]): void {
+    const oref = WOS.makeORef("workspace", workspaceId);
+    fireAndForget(() => ObjectService.UpdateObjectMeta(oref, { [MetaKeyScriptsList]: scripts }));
+}
+
+// Read-modify-write of the scripts array; concurrent edits could theoretically
+// clobber each other, but scripts are edited infrequently by a single user.
+export function recordScriptRun(workspaceId: string, scriptId: string): void {
+    const oref = WOS.makeORef("workspace", workspaceId);
+    const workspace = WOS.getObjectValue<Workspace>(oref);
+    if (!workspace) return;
+    const scripts = getScriptsFromWorkspace(workspace);
+    const updated = scripts.map((s) => (s.id === scriptId ? { ...s, lastused: Date.now() } : s));
+    fireAndForget(() => ObjectService.UpdateObjectMeta(oref, { [MetaKeyScriptsList]: updated }));
+}
+
+// The heredoc/`.` runner only works on POSIX shells (bash/zsh/sh/dash). Non-POSIX
+// shells (fish, Windows cmd/PowerShell) would produce syntax errors, so we detect
+// and block them. WSL/SSH remote connections are assumed POSIX-compatible.
+export function isScriptRunSupportedForBlock(blockId: string): boolean {
+    const connName = globalStore.get(getBlockMetaKeyAtom(blockId, "connection"));
+    if (!isLocalConnName(connName)) {
+        return true; // WSL/SSH remote shells are POSIX
+    }
+    const shellPath = globalStore.get(getOverrideConfigAtom(blockId, "term:localshellpath")) ?? "";
+    if (isWindows()) {
+        return /bash/i.test(shellPath);
+    }
+    // macOS/Linux: fish is the only common non-POSIX shell
+    return !/fish/i.test(shellPath);
+}
+
+export interface ScriptRunResult {
+    ok: boolean;
+    reason?: string;
+}
+
+export function runScript(script: WorkspaceScript, blockIdOverride?: string): ScriptRunResult {
+    const blockId = blockIdOverride ?? getFocusedBlockId();
+    if (blockId == null) {
+        return { ok: false };
+    }
+    const view = globalStore.get(getBlockMetaKeyAtom(blockId, "view"));
+    if (view !== "term") {
+        return { ok: false };
+    }
+    if (!isScriptRunSupportedForBlock(blockId)) {
+        return {
+            ok: false,
+            reason: "Workspace scripts require a POSIX shell (bash/zsh/sh). Switch to bash, zsh, or sh to run scripts.",
+        };
+    }
+    const cmd = buildHeredocCommand(script);
+    RpcApi.ControllerInputCommand(TabRpcClient, { blockid: blockId, inputdata64: stringToBase64(cmd) });
+
+    const workspaceId = globalStore.get(atoms.workspaceId);
+    if (workspaceId) {
+        recordScriptRun(workspaceId, script.id);
+    }
+    return { ok: true };
+}
diff --git a/frontend/types/gotypes.d.ts b/frontend/types/gotypes.d.ts
index 24a6ceea66..b42fde1fad 100644
--- a/frontend/types/gotypes.d.ts
+++ b/frontend/types/gotypes.d.ts
@@ -1224,6 +1224,7 @@ declare global {
         "bg:activebordercolor"?: string;
         "layout:vtabbarwidth"?: number;
         "layout:widgetsvisible"?: boolean;
+        "scripts:list"?: WorkspaceScript[];
         "waveai:panelopen"?: boolean;
         "waveai:panelwidth"?: number;
         "waveai:model"?: string;
@@ -2277,6 +2278,15 @@ declare global {
         windowid: string;
     };
 
+    // waveobj.WorkspaceScript
+    type WorkspaceScript = {
+        id: string;
+        name: string;
+        command: string;
+        desc?: string;
+        lastused?: number;
+    };
+
     // wshrpc.WshServerCommandMeta
     type WshServerCommandMeta = {
         commandtype: string;
diff --git a/pkg/waveobj/metaconsts.go b/pkg/waveobj/metaconsts.go
index d7ccff18e2..5f268a8053 100644
--- a/pkg/waveobj/metaconsts.go
+++ b/pkg/waveobj/metaconsts.go
@@ -105,6 +105,8 @@ const (
 	MetaKey_LayoutVTabBarWidth               = "layout:vtabbarwidth"
 	MetaKey_LayoutWidgetsVisible             = "layout:widgetsvisible"
 
+	MetaKey_ScriptsList                      = "scripts:list"
+
 	MetaKey_WaveAiPanelOpen                  = "waveai:panelopen"
 	MetaKey_WaveAiPanelWidth                 = "waveai:panelwidth"
 	MetaKey_WaveAiModel                      = "waveai:model"
diff --git a/pkg/waveobj/wtype.go b/pkg/waveobj/wtype.go
index ec88719378..1d7ea4516a 100644
--- a/pkg/waveobj/wtype.go
+++ b/pkg/waveobj/wtype.go
@@ -186,6 +186,16 @@ type Workspace struct {
 	Meta            MetaMapType `json:"meta"`
 }
 
+// WorkspaceScript is a user-defined command script stored in a workspace's meta
+// under the "scripts:list" key.
+type WorkspaceScript struct {
+	ID       string `json:"id"`
+	Name     string `json:"name"`
+	Command  string `json:"command"`
+	Desc     string `json:"desc,omitempty"`
+	LastUsed int64  `json:"lastused,omitempty"`
+}
+
 func (*Workspace) GetOType() string {
 	return OType_Workspace
 }
diff --git a/pkg/waveobj/wtypemeta.go b/pkg/waveobj/wtypemeta.go
index baee748cce..2a5fd30ace 100644
--- a/pkg/waveobj/wtypemeta.go
+++ b/pkg/waveobj/wtypemeta.go
@@ -105,8 +105,9 @@ type MetaTSType struct {
 	BgActiveBorderColor string  `json:"bg:activebordercolor,omitempty"` // frame:activebordercolor
 
 	// for workspace
-	LayoutVTabBarWidth   int   `json:"layout:vtabbarwidth,omitempty"`
-	LayoutWidgetsVisible *bool `json:"layout:widgetsvisible,omitempty"`
+	LayoutVTabBarWidth   int               `json:"layout:vtabbarwidth,omitempty"`
+	LayoutWidgetsVisible *bool             `json:"layout:widgetsvisible,omitempty"`
+	ScriptsList          []WorkspaceScript `json:"scripts:list,omitempty"`
 
 	// for tabs+waveai
 	WaveAiPanelOpen     bool   `json:"waveai:panelopen,omitempty"`