musistudio/claude-code-router · error · Error

Profile launcher was not found: ${plan.command}. Re-save the

Error message

Profile launcher was not found: ${plan.command}. Re-save the profile and try again.

What it means

Error "Profile launcher was not found: ${plan.command}. Re-save the profile and try again." thrown in musistudio/claude-code-router.

Source

Thrown at packages/core/src/profiles/launch-service.ts:140

  assertAvailableGatewayModels(config);
  await applyProfileConfig(config);
  const profile = findProfileForOpen(config, request.profileId);
  const surface = resolveProfileOpenSurface(profile, request.surface);
  if (profile.agent === "claude-design") {
    throw new Error("Claude Design profiles can only be opened from CCR Desktop.");
  }
  if (profile.agent === "claude-code" && surface === "app") {
    return openClaudeAppProfile(config, profile);
  }
  if ((profile.agent === "codex" || profile.agent === "workbuddy" || profile.agent === "zcode") && surface === "app") {
    return await openCodexAppProfile(config, profile);
  }
  if (profile.agent === "opencode" && surface === "app") {
    return await openOpenCodeAppProfile(config, profile);
  }
  const plan = buildProfileLaunchPlan(CONFIGDIR, profile, surface);
  if (path.isAbsolute(plan.command) && !existsSync(plan.command)) {
    throw new Error(`Profile launcher was not found: ${plan.command}. Re-save the profile and try again.`);
  }

  const launch = profileLaunchSpawnCommand(plan);
  const child = spawn(launch.command, launch.args, {
    detached: true,
    env: {
      ...process.env,
      ...plan.env,
      ...botGatewayProfileEnv(config, profile, surface),
      ...(profile.agent === "claude-code" ? claudeCodeUtcTimezoneEnvOverride() : {})
    },
    stdio: "ignore"
  });
  const spawnError = await waitForImmediateSpawnError(child, 500);
  if (spawnError) {
    throw new Error(`Failed to open ${profile.name || profile.id}: ${spawnError}`);
  }
  child.unref();

View on GitHub (pinned to 99f24806c6)

When it happens

Trigger: Thrown at packages/core/src/profiles/launch-service.ts:140 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of musistudio/claude-code-router@99f24806c6 (2026-08-27). Data as JSON: /api/errors/c43985a3e631ec48. Report an issue: GitHub.