feat(scripts): add sidecar icons and tags in the admin UI

Serve optional PNG/JPG next to each script and show meta tags in lists, cards, and the editor.

Co-authored-by: Cursor <cursoragent@cursor.com>

packages/web/src/pages/ScriptDryRunPage.jsx

@@ -10,6 +10,7 @@ import {
 } from "../api/hooks.js";
 import { CodeEditor } from "../components/CodeEditor.jsx";
 import { LogViewer } from "../components/LogViewer.jsx";
+import { ScriptIcon } from "../components/ScriptIcon.jsx";
 import { ScriptMetaPanel } from "../components/ScriptMetaPanel.jsx";
 import { StatusBadge } from "../lib/format.jsx";
 import {
@@ -133,6 +134,7 @@ export function ScriptDryRunPage() {
         <Link to={backHref} className="btn btn-ghost btn-sm btn-square" aria-label="Back">
           <LuArrowLeft className="size-4" />
         </Link>
+        <ScriptIcon name={name} hasIcon={existing.data?.hasIcon} className="size-8 shrink-0" />
         <h1 className="truncate font-mono text-lg font-semibold">{name}</h1>
         <span className="badge badge-ghost badge-sm">dry run</span>
         {runStatus ? <StatusBadge status={runStatus} /> : null}

packages/web/src/pages/ScriptEditPage.jsx

@@ -4,6 +4,7 @@ import { LuArrowLeft, LuPlay, LuSave } from "react-icons/lu";
 import { errorMessage } from "../api/client.js";
 import { useSaveScript, useScript } from "../api/hooks.js";
 import { CodeEditor } from "../components/CodeEditor.jsx";
+import { ScriptIcon } from "../components/ScriptIcon.jsx";
 import { ScriptMetaPanel } from "../components/ScriptMetaPanel.jsx";
 import { NEW_SCRIPT_TEMPLATE, normalizeScriptName } from "../lib/script.js";
 
@@ -137,6 +138,7 @@ export function ScriptEditPage() {
         <Link to="/scripts" className="btn btn-ghost btn-sm btn-square" aria-label="Back">
           <LuArrowLeft className="size-4" />
         </Link>
+        <ScriptIcon name={name} hasIcon={existing.data?.hasIcon} className="size-8 shrink-0" />
         <h1 className="truncate font-mono text-xl font-semibold">{name}</h1>
         <div className="flex-1" />
         <button type="button" className="btn btn-outline btn-sm" onClick={openDryRun}>

packages/web/src/pages/ScriptsPage.jsx

@@ -1,8 +1,11 @@
-import { useState } from "react";
+import { useMemo, useState } from "react";
 import { Link, Navigate, useNavigate, useSearchParams } from "react-router-dom";
-import { LuPencil, LuPlay, LuPlus, LuTrash2 } from "react-icons/lu";
+import { LuPencil, LuPlay, LuPlus, LuSearch, LuTrash2 } from "react-icons/lu";
 import { errorMessage } from "../api/client.js";
 import { useDeleteScript, useScripts } from "../api/hooks.js";
+import { ScriptIcon } from "../components/ScriptIcon.jsx";
+import { TagBadge } from "../components/TagBadge.jsx";
+import { scriptTags } from "../lib/script.js";
 
 export function ScriptsPage() {
   const [params] = useSearchParams();
@@ -10,61 +13,108 @@ export function ScriptsPage() {
   const editName = params.get("edit");
   const { data: scripts = [], isLoading } = useScripts();
   const [confirmDelete, setConfirmDelete] = useState(null);
+  const [query, setQuery] = useState("");
   const del = useDeleteScript();
 
+  const visible = useMemo(() => {
+    const term = query.trim().toLowerCase();
+    if (!term) return scripts;
+    return scripts.filter((s) => {
+      const name = typeof s === "string" ? s : s.name ?? "";
+      const description = typeof s === "string" ? "" : s.meta?.description ?? "";
+      const tags = typeof s === "string" ? [] : scriptTags(s.meta);
+      return (
+        name.toLowerCase().includes(term) ||
+        description.toLowerCase().includes(term) ||
+        tags.some((t) => t.toLowerCase().includes(term))
+      );
+    });
+  }, [scripts, query]);
+
   if (editName) {
     return <Navigate to={`/scripts/${encodeURIComponent(editName)}/edit`} replace />;
   }
 
   return (
     <div className="space-y-4">
-      <div className="flex items-center justify-between gap-2">
+      <div className="flex flex-wrap items-center justify-between gap-2">
         <h1 className="text-xl font-semibold">Scripts</h1>
-        <Link to="/scripts/new" className="btn btn-primary btn-sm">
-          <LuPlus className="size-4" />
-          Add
-        </Link>
+        <div className="flex items-center gap-2">
+          <label className="input input-sm w-48 sm:w-64">
+            <LuSearch className="size-4 opacity-60" />
+            <input
+              type="search"
+              className="grow"
+              placeholder="Search scripts"
+              value={query}
+              onChange={(e) => setQuery(e.target.value)}
+            />
+          </label>
+          <Link to="/scripts/new" className="btn btn-primary btn-sm">
+            <LuPlus className="size-4" />
+            Add
+          </Link>
+        </div>
       </div>
 
       {isLoading ? (
         <span className="loading loading-spinner" />
+      ) : scripts.length === 0 ? (
+        <p className="text-sm opacity-50">No scripts yet.</p>
+      ) : visible.length === 0 ? (
+        <p className="text-sm opacity-50">No scripts match “{query.trim()}”.</p>
       ) : (
-        <div className="overflow-x-auto">
-          <table className="table table-sm">
-            <thead>
-              <tr>
-                <th>Name</th>
-                <th>Description</th>
-                <th className="w-28" />
-              </tr>
-            </thead>
-            <tbody>
-              {scripts.map((s) => {
-                const name = typeof s === "string" ? s : s.name;
-                const description = typeof s === "string" ? "" : s.meta?.description;
-                const metaError = typeof s === "string" ? null : s.metaError;
-                return (
-                <tr key={name} className="hover">
-                  <td className="font-mono">
-                    <Link className="link" to={`/scripts/${encodeURIComponent(name)}/edit`}>
-                      {name}
-                    </Link>
-                  </td>
-                  <td className="max-w-xl truncate text-sm opacity-80">
+        <div className="flex flex-wrap gap-3">
+          {visible.map((s) => {
+            const name = typeof s === "string" ? s : s.name;
+            const description = typeof s === "string" ? "" : s.meta?.description;
+            const metaError = typeof s === "string" ? null : s.metaError;
+            const hasIcon = typeof s === "string" ? undefined : s.hasIcon;
+            const tags = typeof s === "string" ? [] : scriptTags(s.meta);
+            return (
+              <article
+                key={name}
+                className="card bg-base-100 border border-base-300 w-60"
+              >
+                <div className="card-body p-4 gap-2">
+                  <Link
+                    to={`/scripts/${encodeURIComponent(name)}/edit`}
+                    className="flex flex-col items-center gap-2 min-h-0"
+                  >
+                    <div className="flex h-20 w-full items-center justify-center rounded-box bg-base-200">
+                      <ScriptIcon name={name} hasIcon={hasIcon} className="size-14" />
+                    </div>
+                    <h2 className="card-title font-mono text-sm justify-center text-center w-full">
+                      <span className="truncate" title={name}>
+                        {name}
+                      </span>
+                    </h2>
+                  </Link>
+                  <p className="text-xs opacity-80 line-clamp-2 min-h-8">
                     {metaError ? (
                       <span className="text-error">{metaError}</span>
                     ) : (
                       description || "—"
                     )}
-                  </td>
-                  <td className="text-right whitespace-nowrap">
+                  </p>
+                  {tags.length ? (
+                    <div className="flex flex-wrap gap-1">
+                      {tags.map((tag) => (
+                        <TagBadge
+                          key={tag}
+                          tag={tag}
+                          title={`Search ${tag}`}
+                          onClick={() => setQuery(tag)}
+                        />
+                      ))}
+                    </div>
+                  ) : null}
+                  <div className="card-actions justify-end mt-1">
                     <button
                       type="button"
                       className="btn btn-ghost btn-xs"
                       title="Dry run"
-                      onClick={() =>
-                        navigate(`/scripts/${encodeURIComponent(name)}/dry-run`)
-                      }
+                      onClick={() => navigate(`/scripts/${encodeURIComponent(name)}/dry-run`)}
                     >
                       <LuPlay className="size-4" />
                     </button>
@@ -83,12 +133,11 @@ export function ScriptsPage() {
                     >
                       <LuTrash2 className="size-4" />
                     </button>
-                  </td>
-                </tr>
-                );
-              })}
-            </tbody>
-          </table>
+                  </div>
+                </div>
+              </article>
+            );
+          })}
         </div>
       )}