chenhg5/cc-connect · error

start: %s (%w)

Error message

start: %s (%w)

What it means

launchdManager.Start wraps launchctl kickstart -kp failure (with launchd output) when the service is already loaded; if not loaded anywhere it falls through to bootstrap instead, so this error means 'loaded but refused to start'.

Source

Thrown at daemon/launchd.go:95

	}
	return nil
}

func (m *launchdManager) Uninstall() error {
	bootoutLaunchdTargets()

	plistPath := launchdPlistPath()
	if err := os.Remove(plistPath); err != nil && !os.IsNotExist(err) {
		return fmt.Errorf("remove plist: %w", err)
	}
	return nil
}

func (*launchdManager) Start() error {
	if _, target, _, ok := loadedLaunchdTarget(); ok {
		out, err := runLaunchctl("kickstart", "-kp", target)
		if err != nil {
			return fmt.Errorf("start: %s (%w)", out, err)
		}
		return nil
	}

	domain := preferredLaunchdDomain()
	plistPath := launchdPlistPath()
	var out string
	if _, err := runLaunchctl("bootstrap", domain, plistPath); err != nil {
		// already bootstrapped — try kickstart
		out, err = runLaunchctl("kickstart", "-kp", launchdTarget(domain))
		if err != nil {
			return fmt.Errorf("start: %s (%w)", out, err)
		}
	}
	return nil
}

func (*launchdManager) Stop() error {

View on GitHub (pinned to 4000b2338a)

Solutions

  1. Check service logs for why the process exits immediately
  2. Run Status to confirm the job is loaded and inspect its last exit status
Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at daemon/launchd.go:95 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of chenhg5/cc-connect@4000b2338a (2026-09-06). Data as JSON: /api/errors/03c755aae1c0cc96. Report an issue: GitHub.