What causes "Workflow '${slug}' not found" in coleam00/Archon?

Run `archon workflow search` and copy the exact slug from the listing

Workflow '${slug}' not found

Error message

Workflow '${slug}' not found

What it means

Thrown by `workflowInstallCommand` when the requested slug does not match any entry in the fetched marketplace listing. A friendlier message is printed first suggesting `archon workflow search`. This is the user-facing 'typo or stale marketplace' failure of the install command.

Source

Thrown at packages/cli/src/commands/workflow.ts:5147

  }
  if (!res.ok) {
    throw new Error(`Source fetch failed: HTTP ${String(res.status)} from ${rawUrl}`);
  }
  return res.text();
}

export async function workflowInstallCommand(
  slug: string,
  cwd: string,
  force?: boolean
): Promise<void> {
  const entries = await fetchMarketplace();
  const entry = entries.find(e => e.slug === slug);

  if (!entry) {
    console.error(`Error: Workflow '${slug}' not found in marketplace.`);
    console.error("Run 'archon workflow search' to browse available workflows.");
    throw new Error(`Workflow '${slug}' not found`);
  }

  if (!entry.sourceUrl.startsWith('https://github.com/')) {
    throw new Error(
      `Untrusted source URL for '${slug}': ${entry.sourceUrl}\nOnly github.com sources are permitted.`
    );
  }

  if (!/^[a-z0-9-]+$/.test(slug)) {
    throw new Error(`Invalid slug '${slug}': must be lowercase alphanumeric with hyphens only.`);
  }

  const { findRepoRoot } = await import('@archon/git');
  const repoRoot = await findRepoRoot(cwd);
  if (!repoRoot) {
    throw new Error('Not in a git repository. Run archon workflow install from within a git repo.');
  }

View on GitHub (pinned to 0773b97458)

Solutions

Run `archon workflow search` and copy the exact slug from the listing
Check for character differences (hyphens vs underscores, casing)
Update the CLI / refresh the marketplace index if it is stale
If the workflow was removed upstream, pick an alternative workflow

Example fix

// before
archon workflow install CodReview
// after
archon workflow install code-review

Defensive patterns

Strategy: validation

Validate before calling

const known = await fetchMarketplace();
if (!known.some(e => e.slug === slug)) {
  console.error(`Unknown slug '${slug}'. Available: ${known.slice(0, 10).map(e => e.slug).join(', ')}...`);
  process.exit(2);
}

Try / catch

try {
  await workflowInstallCommand(slug);
} catch (e) {
  if (e instanceof Error && e.message.endsWith("not found")) {
    // suggest: archon workflow search, or handle slug rename/removal
  } else throw e;
}

Prevention

Copy slugs directly from `archon workflow search` output instead of typing them
Watch for marketplace index changes if workflows were recently renamed
Script installs against a validated slug list
Distinguish display names from slugs — only slugs work with install

When it happens

Trigger: `archon workflow install <slug>` where `entries.find(e => e.slug === slug)` from `fetchMarketplace()` returns undefined: slug typo, the workflow was removed/renamed in the marketplace index, or the marketplace index failed to load partially.

Common situations: Typos in the slug (`code-review` vs `code_review`); the workflow was unpublished upstream; cached/older CLI seeing a newer marketplace; misreading a workflow display name as its slug.

Understand the failure class

Background: 'Could not be found', 'does not exist', 'not found in database': the resource-not-found family when an ID, slug, key, or URI lookup comes back empty — this error's family across 20 libraries.

Related errors

AI-assisted analysis of coleam00/Archon@0773b97458 (2026-09-01). Data as JSON: /api/errors/69b6e0eb19027aac. Report an issue: GitHub.