router-for-me/CLIProxyAPI · error

home plugins: plugin %s install failed

Error message

home plugins: plugin %s install failed

What it means

Error "home plugins: plugin %s install failed" thrown in router-for-me/CLIProxyAPI.

Source

Thrown at internal/homeplugins/sync.go:697

		return nil
	}
	report.Phase = pluginTaskPhaseLoad
	var loadErrors []error
	preserveSyncError := !report.OK && strings.TrimSpace(report.Error) != ""
	if preserveSyncError {
		loadErrors = append(loadErrors, errors.New(report.Error))
	}
	for index := range report.Plugins {
		status := &report.Plugins[index]
		if status.InstallStatus == pluginInstallStatusFailed {
			if status.LoadStatus == "" {
				status.LoadStatus = pluginInstallStatusSkipped
			}
			if !preserveSyncError {
				if strings.TrimSpace(status.Error) != "" {
					loadErrors = append(loadErrors, errors.New(status.Error))
				} else {
					loadErrors = append(loadErrors, fmt.Errorf("home plugins: plugin %s install failed", status.ID))
				}
			}
			continue
		}
		if inspector != nil && inspector.PluginRegistered(status.ID) {
			status.LoadStatus = pluginLoadStatusLoaded
			continue
		}
		status.LoadStatus = pluginLoadStatusFailed
		errLoad := fmt.Errorf("home plugins: plugin %s installed but not loaded", status.ID)
		if strings.TrimSpace(status.Error) == "" {
			status.Error = errLoad.Error()
		}
		loadErrors = append(loadErrors, errLoad)
	}
	errLoad := errors.Join(loadErrors...)
	finishReport(report, errLoad)
	return errLoad

View on GitHub (pinned to 78f0c4079e)

Solutions

1. Check earlier logged errors for the named plugin's install failure cause.
2. Retry the install after resolving artifact or checksum issues.

When it happens

Trigger: Thrown at internal/homeplugins/sync.go:697 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of router-for-me/CLIProxyAPI@78f0c4079e (2026-08-15). Data as JSON: /api/errors/c9f21ff18eca5fa1. Report an issue: GitHub.