promptslide 0.3.11 → 0.3.13

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.3.13](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.12...promptslide-v0.3.13) (2026-03-29)
+
+
+### Bug Fixes
+
+* pin dependency versions and preserve component names in publish pipeline ([#89](https://github.com/prompticeu/promptslide/issues/89)) ([22b7dcb](https://github.com/prompticeu/promptslide/commit/22b7dcbe33c9852fac2fbfef70943254a0d871cd))
+
+## [0.3.12](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.11...promptslide-v0.3.12) (2026-03-28)
+
+
+### Features
+
+* add clone command, make create --from always template ([#87](https://github.com/prompticeu/promptslide/issues/87)) ([769fa7e](https://github.com/prompticeu/promptslide/commit/769fa7ed0ee77f7473f49f2eb608ca996142f3fd))
+
 ## [0.3.11](https://github.com/prompticeu/promptslide/compare/promptslide-v0.3.10...promptslide-v0.3.11) (2026-03-25)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptslide",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "CLI and slide engine for PromptSlide presentations",
   "type": "module",
   "main": "./dist/index.js",

package/src/commands/add.mjs

@@ -167,7 +167,7 @@ export async function add(args) {
     const shouldReplace = await confirm("  Replace entire deck-config.ts with this deck?", true)
     if (shouldReplace) {
       const slides = item.meta.slides.map(s => ({
-        componentName: toPascalCase(s.slug),
+        componentName: s.componentName || toPascalCase(s.slug),
         importPath: `@/slides/${s.slug}`,
         steps: s.steps,
         section: s.section
@@ -180,7 +180,7 @@ export async function add(args) {
     } else {
       // Append individual slides
       for (const s of item.meta.slides) {
-        const componentName = toPascalCase(s.slug)
+        const componentName = s.componentName || toPascalCase(s.slug)
         const importPath = `@/slides/${s.slug}`
         const updated = addSlideToDeckConfig(cwd, { componentName, importPath, steps: s.steps })
         if (updated) {

package/src/commands/clone.mjs

@@ -0,0 +1,231 @@
+import { existsSync, cpSync, readFileSync, writeFileSync, mkdirSync } from "node:fs"
+import { join, resolve, dirname } from "node:path"
+import { fileURLToPath } from "node:url"
+
+import { bold, green, cyan, red, dim, yellow } from "../utils/ansi.mjs"
+import { requireAuth } from "../utils/auth.mjs"
+import { hexToOklch } from "../utils/colors.mjs"
+import { closePrompts } from "../utils/prompts.mjs"
+import { fetchRegistryItem, resolveRegistryDependencies, writeLockfile } from "../utils/registry.mjs"
+import { toPascalCase, replaceDeckConfig } from "../utils/deck-config.mjs"
+import { ensureTsConfig } from "../utils/tsconfig.mjs"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const CLI_ROOT = join(__dirname, "..", "..")
+const TEMPLATE_DIR = join(CLI_ROOT, "templates", "default")
+const CLI_VERSION = JSON.parse(readFileSync(join(CLI_ROOT, "package.json"), "utf-8")).version
+
+function replaceInFile(filePath, replacements) {
+  let content = readFileSync(filePath, "utf-8")
+  for (const [placeholder, value] of Object.entries(replacements)) {
+    content = content.replaceAll(placeholder, value)
+  }
+  writeFileSync(filePath, content, "utf-8")
+}
+
+export async function clone(args) {
+  console.log()
+  console.log(`  ${bold("promptslide")} ${dim("clone")}`)
+  console.log()
+
+  if (args[0] === "--help" || args[0] === "-h") {
+    console.log(`  ${bold("Usage:")} promptslide clone ${dim("<deck-slug>")}`)
+    console.log()
+    console.log(`  Clone a published deck to continue working on it locally.`)
+    console.log(`  The deck stays linked for pull/publish.`)
+    console.log()
+    console.log(`  ${bold("Examples:")}`)
+    console.log(`    promptslide clone statworx-slide-master`)
+    console.log()
+    process.exit(0)
+  }
+
+  const slug = args[0]
+
+  if (!slug) {
+    console.error(`  ${red("Error:")} Please provide a deck slug.`)
+    console.error(`  ${dim("Usage:")} promptslide clone ${dim("<deck-slug>")}`)
+    console.log()
+    process.exit(1)
+  }
+
+  // 1. Authenticate and fetch deck
+  const auth = requireAuth()
+
+  let item
+  try {
+    item = await fetchRegistryItem(slug, auth)
+  } catch (err) {
+    console.error(`  ${red("Error:")} ${err.message}`)
+    process.exit(1)
+  }
+
+  if (item.type !== "deck") {
+    console.error(`  ${red("Error:")} "${slug}" is a ${item.type}, not a deck. Only decks can be cloned.`)
+    process.exit(1)
+  }
+
+  const versionTag = item.version ? ` ${dim(`v${item.version}`)}` : ""
+  console.log(`  Cloning ${bold(item.title || item.name)}${versionTag}`)
+
+  if (item.promptslideVersion) {
+    const pubParts = item.promptslideVersion.match(/^(\d+)\.(\d+)/)
+    const localParts = CLI_VERSION.match(/^(\d+)\.(\d+)/)
+    if (pubParts && localParts && pubParts[2] !== localParts[2]) {
+      console.log()
+      console.log(`  ${yellow("⚠")} This deck was published with promptslide ${bold(`v${item.promptslideVersion}`)}`)
+      console.log(`    You have ${bold(`v${CLI_VERSION}`)} installed — some slides may need updating.`)
+    }
+  }
+
+  console.log()
+
+  // 2. Use slug as directory name
+  const dirName = slug
+  const targetDir = resolve(process.cwd(), dirName)
+
+  if (existsSync(targetDir)) {
+    console.error(`  ${red("Error:")} Directory "${dirName}" already exists.`)
+    process.exit(1)
+  }
+
+  // 3. Scaffold base template
+  cpSync(TEMPLATE_DIR, targetDir, { recursive: true })
+
+  const projectName = item.title || slug
+  const primaryOklch = hexToOklch("#3B82F6")
+
+  const replacements = [
+    {
+      path: join(targetDir, "package.json"),
+      values: { "{{PROJECT_SLUG}}": dirName, "{{PROJECT_NAME}}": projectName, "{{PROMPTSLIDE_VERSION}}": `^${CLI_VERSION}` }
+    },
+    {
+      path: join(targetDir, "src", "theme.ts"),
+      values: { "{{PROJECT_NAME}}": projectName }
+    },
+    {
+      path: join(targetDir, "src", "slides", "slide-title.tsx"),
+      values: { "{{PROJECT_NAME}}": projectName }
+    },
+    {
+      path: join(targetDir, "README.md"),
+      values: { "{{PROJECT_NAME}}": projectName }
+    },
+    {
+      path: join(targetDir, "src", "globals.css"),
+      values: { "{{PRIMARY_COLOR}}": primaryOklch }
+    }
+  ]
+
+  for (const { path, values } of replacements) {
+    replaceInFile(path, values)
+  }
+
+  // 4. Create lockfile linked to the original deck
+  writeLockfile(targetDir, {
+    deckSlug: slug,
+    deckMeta: { title: "", description: "", tags: [] },
+    items: {}
+  })
+
+  // 5. Resolve dependencies and write deck files
+  let resolved
+  try {
+    resolved = await resolveRegistryDependencies(item, auth, targetDir)
+  } catch (err) {
+    console.error(`  ${red("Error:")} ${err.message}`)
+    process.exit(1)
+  }
+
+  for (const regItem of resolved.items) {
+    if (!regItem.files?.length) continue
+    for (const file of regItem.files) {
+      const targetPath = join(targetDir, file.target, file.path)
+      const targetFileDir = dirname(targetPath)
+      mkdirSync(targetFileDir, { recursive: true })
+
+      const dataUriPrefix = file.content.match(/^data:[^;]+;base64,/)
+      if (dataUriPrefix) {
+        writeFileSync(targetPath, Buffer.from(file.content.slice(dataUriPrefix[0].length), "base64"))
+      } else {
+        writeFileSync(targetPath, file.content, "utf-8")
+      }
+      console.log(`  ${green("✓")} Added ${cyan(file.target + file.path)}`)
+    }
+  }
+
+  // 6. Generate deck-config.ts
+  if (item.meta?.slides) {
+    const slides = item.meta.slides.map(s => ({
+      componentName: s.componentName || toPascalCase(s.slug),
+      importPath: `@/slides/${s.slug}`,
+      steps: s.steps,
+      section: s.section
+    }))
+    replaceDeckConfig(targetDir, slides, {
+      transition: item.meta.transition,
+      directionalTransition: item.meta.directionalTransition
+    })
+    console.log(`  ${green("✓")} Generated ${cyan("deck-config.ts")} ${dim(`(${slides.length} slides)`)}`)
+  }
+
+  // 7. Add npm dependencies
+  if (Object.keys(resolved.npmDeps).length > 0) {
+    const pkgList = Object.entries(resolved.npmDeps).map(([name, ver]) => `${name}@${ver}`)
+    const pkgPath = join(targetDir, "package.json")
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"))
+    for (const [name, ver] of Object.entries(resolved.npmDeps)) {
+      pkg.dependencies = pkg.dependencies || {}
+      pkg.dependencies[name] = ver
+    }
+    writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8")
+    console.log(`  ${green("✓")} Added ${dim(pkgList.join(", "))} to package.json`)
+  }
+
+  // 8. Fetch annotations
+  if (item.id) {
+    try {
+      const annotationsRes = await fetch(`${auth.registry}/api/items/${item.id}/annotations`, {
+        headers: { Authorization: `Bearer ${auth.token}`, ...(auth.organizationId ? { "X-Organization-Id": auth.organizationId } : {}) }
+      })
+      if (annotationsRes.ok) {
+        const data = await annotationsRes.json()
+        const annotations = data.annotations ?? []
+        if (annotations.length > 0) {
+          const annotationsFile = { version: 1, annotations: annotations.map(a => ({
+            id: a.id,
+            slideIndex: a.slideIndex,
+            slideTitle: a.slideTitle,
+            target: a.target,
+            body: a.body,
+            createdAt: a.createdAt,
+            status: a.status,
+            ...(a.resolution ? { resolution: a.resolution } : {})
+          })) }
+          writeFileSync(join(targetDir, "annotations.json"), JSON.stringify(annotationsFile, null, 2) + "\n", "utf-8")
+          console.log(`  ${green("✓")} Pulled ${cyan("annotations.json")} ${dim(`(${annotations.length} annotation${annotations.length === 1 ? "" : "s"})`)}`)
+        }
+      }
+    } catch {
+      // Annotations are non-critical; don't fail the clone
+    }
+  }
+
+  // 9. Generate tsconfig.json
+  ensureTsConfig(targetDir)
+
+  // 10. Success output
+  console.log()
+  console.log(`  ${green("✓")} Cloned ${bold(projectName)} in ${cyan(dirName)}/`)
+  console.log()
+  console.log(`  ${bold("Next steps:")}`)
+  console.log()
+  console.log(`    cd ${dirName}`)
+  console.log(`    bun install`)
+  console.log(`    bun run dev`)
+  console.log()
+
+  closePrompts()
+}

package/src/commands/create.mjs

@@ -7,7 +7,7 @@ import { bold, green, cyan, red, dim, yellow } from "../utils/ansi.mjs"
 import { requireAuth } from "../utils/auth.mjs"
 import { hexToOklch, isValidHex } from "../utils/colors.mjs"
 import { prompt, confirm, closePrompts } from "../utils/prompts.mjs"
-import { fetchRegistryItem, resolveRegistryDependencies, updateLockfilePublishConfig, writeLockfile } from "../utils/registry.mjs"
+import { fetchRegistryItem, resolveRegistryDependencies, writeLockfile } from "../utils/registry.mjs"
 import { toPascalCase, replaceDeckConfig } from "../utils/deck-config.mjs"
 import { ensureTsConfig } from "../utils/tsconfig.mjs"
 
@@ -48,7 +48,7 @@ export async function create(args) {
   let dirName = filteredArgs[0]
 
   if (dirName === "--help" || dirName === "-h") {
-    console.log(`  ${bold("Usage:")} promptslide create ${dim("<project-directory>")} ${dim("[options]")}`)
+    console.log(`  ${bold("Usage:")} promptslide create ${dim("[project-directory]")} ${dim("[options]")}`)
     console.log()
     console.log(`  Scaffolds a new PromptSlide slide deck project.`)
     console.log()
@@ -59,11 +59,47 @@ export async function create(args) {
     console.log(`  ${bold("Examples:")}`)
     console.log(`    promptslide create my-pitch-deck`)
     console.log(`    promptslide create my-pitch-deck --yes`)
-    console.log(`    promptslide create my-deck --from promptic-pitch-deck`)
+    console.log(`    promptslide create --from promptic-pitch-deck`)
     console.log()
     process.exit(0)
   }
 
+  // If --from is specified, fetch the deck info before the directory prompt
+  let fromItem = null
+  let fromAuth = null
+  if (fromSlug) {
+    fromAuth = requireAuth()
+
+    try {
+      fromItem = await fetchRegistryItem(fromSlug, fromAuth)
+    } catch (err) {
+      console.error(`  ${red("Error:")} ${err.message}`)
+      closePrompts()
+      process.exit(1)
+    }
+
+    if (fromItem.type !== "deck") {
+      console.error(`  ${red("Error:")} "${fromSlug}" is a ${fromItem.type}, not a deck. Use --from with a published deck.`)
+      closePrompts()
+      process.exit(1)
+    }
+
+    const versionTag = fromItem.version ? ` ${dim(`v${fromItem.version}`)}` : ""
+    console.log(`  Using deck ${bold(fromItem.title || fromItem.name)}${versionTag} as template`)
+
+    if (fromItem.promptslideVersion) {
+      const pubParts = fromItem.promptslideVersion.match(/^(\d+)\.(\d+)/)
+      const localParts = CLI_VERSION.match(/^(\d+)\.(\d+)/)
+      if (pubParts && localParts && pubParts[2] !== localParts[2]) {
+        console.log()
+        console.log(`  ${yellow("⚠")} This deck was published with promptslide ${bold(`v${fromItem.promptslideVersion}`)}`)
+        console.log(`    You have ${bold(`v${CLI_VERSION}`)} installed — some slides may need updating.`)
+      }
+    }
+
+    console.log()
+  }
+
   if (!dirName) {
     if (useDefaults) {
       console.error(`  ${red("Error:")} Please provide a project directory name when using --yes.`)
@@ -156,40 +192,9 @@ export async function create(args) {
 
   // 7. Overlay deck files if --from was specified
   if (fromSlug) {
-    const auth = requireAuth()
-
-    let item
-    try {
-      item = await fetchRegistryItem(fromSlug, auth)
-    } catch (err) {
-      console.error(`  ${red("Error:")} ${err.message}`)
-      closePrompts()
-      process.exit(1)
-    }
-
-    if (item.type !== "deck") {
-      console.error(`  ${red("Error:")} "${fromSlug}" is a ${item.type}, not a deck. Use --from with a published deck.`)
-      closePrompts()
-      process.exit(1)
-    }
-
-    const versionTag = item.version ? ` ${dim(`v${item.version}`)}` : ""
-    console.log(`  Using deck ${bold(item.title || item.name)}${versionTag}`)
-
-    // Warn if the deck was published with a different minor version
-    if (item.promptslideVersion) {
-      const pubParts = item.promptslideVersion.match(/^(\d+)\.(\d+)/)
-      const localParts = CLI_VERSION.match(/^(\d+)\.(\d+)/)
-      if (pubParts && localParts && pubParts[2] !== localParts[2]) {
-        console.log()
-        console.log(`  ${yellow("⚠")} This deck was published with promptslide ${bold(`v${item.promptslideVersion}`)}`)
-        console.log(`    You have ${bold(`v${CLI_VERSION}`)} installed — some slides may need updating.`)
-      }
-    }
-
     let resolved
     try {
-      resolved = await resolveRegistryDependencies(item, auth, targetDir)
+      resolved = await resolveRegistryDependencies(fromItem, fromAuth, targetDir)
     } catch (err) {
       console.error(`  ${red("Error:")} ${err.message}`)
       closePrompts()
@@ -215,16 +220,16 @@ export async function create(args) {
     }
 
     // Reconstruct deck-config.ts from deckConfig metadata
-    if (item.meta?.slides) {
-      const slides = item.meta.slides.map(s => ({
-        componentName: toPascalCase(s.slug),
+    if (fromItem.meta?.slides) {
+      const slides = fromItem.meta.slides.map(s => ({
+        componentName: s.componentName || toPascalCase(s.slug),
         importPath: `@/slides/${s.slug}`,
         steps: s.steps,
         section: s.section
       }))
       replaceDeckConfig(targetDir, slides, {
-        transition: item.meta.transition,
-        directionalTransition: item.meta.directionalTransition
+        transition: fromItem.meta.transition,
+        directionalTransition: fromItem.meta.directionalTransition
       })
       console.log(`  ${green("✓")} Generated ${cyan("deck-config.ts")} ${dim(`(${slides.length} slides)`)}`)
     }
@@ -242,37 +247,8 @@ export async function create(args) {
       console.log(`  ${green("✓")} Added ${dim(pkgList.join(", "))} to package.json`)
     }
 
-    // Persist deck slug for future pull/publish in the new project
-    updateLockfilePublishConfig(targetDir, { deckSlug: fromSlug })
-
-    // Fetch annotations from registry
-    if (item.id) {
-      try {
-        const annotationsRes = await fetch(`${auth.registry}/api/items/${item.id}/annotations`, {
-          headers: { Authorization: `Bearer ${auth.token}`, ...(auth.organizationId ? { "X-Organization-Id": auth.organizationId } : {}) }
-        })
-        if (annotationsRes.ok) {
-          const data = await annotationsRes.json()
-          const annotations = data.annotations ?? []
-          if (annotations.length > 0) {
-            const annotationsFile = { version: 1, annotations: annotations.map(a => ({
-              id: a.id,
-              slideIndex: a.slideIndex,
-              slideTitle: a.slideTitle,
-              target: a.target,
-              body: a.body,
-              createdAt: a.createdAt,
-              status: a.status,
-              ...(a.resolution ? { resolution: a.resolution } : {})
-            })) }
-            writeFileSync(join(targetDir, "annotations.json"), JSON.stringify(annotationsFile, null, 2) + "\n", "utf-8")
-            console.log(`  ${green("✓")} Pulled ${cyan("annotations.json")} ${dim(`(${annotations.length} annotation${annotations.length === 1 ? "" : "s"})`)}`)
-          }
-        }
-      } catch {
-        // Annotations are non-critical; don't fail the create
-      }
-    }
+    // New deck identity — deckSlug stays as dirName (set in initial lockfile scaffold)
+    console.log(`  ${dim("Deck slug set to")} ${bold(dirName)} ${dim("(publish will create a new deck)")}`)
 
     console.log()
   }

package/src/commands/publish.mjs

@@ -71,7 +71,7 @@ function detectSteps(content) {
   return max
 }
 
-function detectNpmDeps(content) {
+function detectNpmDeps(content, projectDeps = {}) {
   const deps = {}
   // Match both unscoped (foo) and scoped (@scope/foo) packages, exclude relative imports
   const importRegex = /import\s+.*?\s+from\s+["']((?:@[a-zA-Z0-9-]+\/)?[a-zA-Z0-9-][^"']*)["']/g
@@ -81,7 +81,7 @@ function detectNpmDeps(content) {
     const pkg = full.startsWith("@") ? full.split("/").slice(0, 2).join("/") : full.split("/")[0]
     // Skip relative imports, react, and internal packages
     if (pkg.startsWith(".") || pkg === "react" || pkg === "react-dom" || pkg.startsWith("@promptslide/")) continue
-    deps[pkg] = "latest"
+    deps[pkg] = projectDeps[pkg] ?? "latest"
   }
   return deps
 }
@@ -96,6 +96,15 @@ function detectRegistryDeps(content) {
   return deps
 }
 
+function readProjectDeps(cwd) {
+  const pkgPath = join(cwd, "package.json")
+  if (!existsSync(pkgPath)) return {}
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"))
+    return { ...pkg.devDependencies, ...pkg.dependencies }
+  } catch { return {} }
+}
+
 /** Detect sibling layout imports — both relative ("./foo") and absolute ("@/layouts/foo"). */
 function detectLayoutSiblingDeps(content) {
   const deps = []
@@ -321,7 +330,7 @@ async function publishItem({ filePath, cwd, auth, typeOverride, interactive = tr
 
   const type = typeOverride || detectType(filePath) || "slide"
   const steps = detectSteps(content)
-  const npmDeps = detectNpmDeps(content)
+  const npmDeps = detectNpmDeps(content, readProjectDeps(cwd))
   const registryDeps = detectRegistryDeps(content)
   const target = type === "layout" ? "src/layouts/" : "src/slides/"
 
@@ -396,6 +405,7 @@ async function publishItem({ filePath, cwd, auth, typeOverride, interactive = tr
 
 export async function publish(args) {
   const cwd = process.cwd()
+  const projectDeps = readProjectDeps(cwd)
 
   console.log()
   console.log(`  ${bold("promptslide")} ${dim("publish")}`)
@@ -692,7 +702,7 @@ export async function publish(args) {
         skipped++
       } else {
         const assetDeps = detectAssetDepsInContent(themeContent, deckSlug, publicFileSet)
-        const npmDeps = detectNpmDeps(themeContent)
+        const npmDeps = detectNpmDeps(themeContent, projectDeps)
 
         try {
           const result = await publishToRegistry({
@@ -730,7 +740,7 @@ export async function publish(args) {
         }
 
         const assetDeps = detectAssetDepsInContent(content, deckSlug, publicFileSet)
-        const npmDeps = detectNpmDeps(content)
+        const npmDeps = detectNpmDeps(content, projectDeps)
         const siblingDeps = detectLayoutSiblingDeps(content).map(d => `${deckSlug}/${d}`)
         const regDeps = hasTheme ? [`${deckSlug}/theme`] : []
         regDeps.push(...siblingDeps, ...assetDeps)
@@ -775,7 +785,7 @@ export async function publish(args) {
 
         const assetDeps = detectAssetDepsInContent(content, deckSlug, publicFileSet)
         const layoutDeps = detectRegistryDeps(content).map(d => `${deckSlug}/${d}`)
-        const npmDeps = detectNpmDeps(content)
+        const npmDeps = detectNpmDeps(content, projectDeps)
         const steps = detectSteps(content)
         const slideConfig = deckConfig.slides.find(s => s.slug === slideName)
         const section = slideConfig?.section || undefined
@@ -836,7 +846,7 @@ export async function publish(args) {
     // Collect npm deps from shared source files
     const sharedNpmDeps = {}
     for (const f of sharedFiles) {
-      Object.assign(sharedNpmDeps, detectNpmDeps(f.content))
+      Object.assign(sharedNpmDeps, detectNpmDeps(f.content, projectDeps))
     }
 
     let deckItemId = null
@@ -905,7 +915,7 @@ export async function publish(args) {
   // Detect metadata
   const type = typeOverride || detectType(filePath) || "slide"
   const steps = detectSteps(content)
-  const npmDeps = detectNpmDeps(content)
+  const npmDeps = detectNpmDeps(content, projectDeps)
   const registryDeps = detectRegistryDeps(content)
   const target = type === "layout" ? "src/layouts/" : "src/slides/"
 

package/src/index.mjs

@@ -20,6 +20,7 @@ function printHelp() {
   console.log()
   console.log(`  ${bold("Commands:")}`)
   console.log(`    create ${dim("<dir>")}   Scaffold a new slide deck project`)
+  console.log(`    clone ${dim("<slug>")}    Clone a published deck to work on it`)
   console.log(`    studio          Start the development studio`)
   console.log(`    build           Build for production`)
   console.log(`    preview         Preview the production build`)
@@ -55,6 +56,11 @@ switch (command) {
     await create(args)
     break
   }
+  case "clone": {
+    const { clone } = await import("./commands/clone.mjs")
+    await clone(args)
+    break
+  }
   case "studio": {
     const { studio } = await import("./commands/studio.mjs")
     await studio(args)

package/src/utils/registry.mjs

@@ -190,36 +190,53 @@ export async function fetchOrganizations(auth) {
  * @param {{ registry: string, apiKey: string }} auth - Auth credentials
  * @returns {Promise<object>} Registry item JSON
  */
-export async function fetchRegistryItem(nameOrUrl, auth) {
+export async function fetchRegistryItem(nameOrUrl, auth, { retries = 2 } = {}) {
   const url = nameOrUrl.startsWith("http")
     ? nameOrUrl
     : `${auth.registry}/api/r/${nameOrUrl}.json`
 
-  const res = await fetch(url, {
-    headers: authHeaders(auth)
-  })
+  let lastError
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      const res = await fetch(url, {
+        headers: authHeaders(auth)
+      })
 
-  if (res.status === 401) {
-    throw new Error("Authentication failed. Run `promptslide login` to re-authenticate.")
-  }
-  if (res.status === 403) {
-    const body = await res.json().catch(() => ({}))
-    if (body.status === "pending_review") {
-      throw new Error(`Item "${nameOrUrl}" is pending review. An admin must approve it first.`)
-    }
-    if (body.status === "rejected") {
-      throw new Error(`Item "${nameOrUrl}" was rejected by an admin.`)
+      if (res.status === 401) {
+        throw new Error("Authentication failed. Run `promptslide login` to re-authenticate.")
+      }
+      if (res.status === 403) {
+        const body = await res.json().catch(() => ({}))
+        if (body.status === "pending_review") {
+          throw new Error(`Item "${nameOrUrl}" is pending review. An admin must approve it first.`)
+        }
+        if (body.status === "rejected") {
+          throw new Error(`Item "${nameOrUrl}" was rejected by an admin.`)
+        }
+        throw new Error("Access denied. This item belongs to a different organization.")
+      }
+      if (res.status === 404) {
+        throw new Error(`Item not found: ${nameOrUrl}`)
+      }
+      if (!res.ok) {
+        throw new Error(`Registry error (${res.status}): ${await res.text()}`)
+      }
+
+      return res.json()
+    } catch (err) {
+      lastError = err
+      // Only retry on network errors (fetch failed), not on HTTP-level errors
+      if (err.message.includes("Authentication") || err.message.includes("Access denied") ||
+          err.message.includes("not found") || err.message.includes("pending review") ||
+          err.message.includes("rejected") || err.message.includes("Registry error")) {
+        throw err
+      }
+      if (attempt < retries) {
+        await new Promise(r => setTimeout(r, 500 * (attempt + 1)))
+      }
     }
-    throw new Error("Access denied. This item belongs to a different organization.")
-  }
-  if (res.status === 404) {
-    throw new Error(`Item not found: ${nameOrUrl}`)
   }
-  if (!res.ok) {
-    throw new Error(`Registry error (${res.status}): ${await res.text()}`)
-  }
-
-  return res.json()
+  throw lastError
 }
 
 /**