{"record":{"id":"75a8523fb84354ce","repo":"slopus/happy","slug":"daemon-installation-is-currently-only-supported-on","errorCode":null,"errorMessage":"Daemon installation is currently only supported on macOS","messagePattern":"Daemon installation is currently only supported on macOS","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/happy-cli/src/daemon/install.ts","lineNumber":6,"sourceCode":"import { logger } from '@/ui/logger';\nimport { install as installMac } from './mac/install';\n\nexport async function install(): Promise<void> {\n    if (process.platform !== 'darwin') {\n        throw new Error('Daemon installation is currently only supported on macOS');\n    }\n    \n    if (process.getuid && process.getuid() !== 0) {\n        throw new Error('Daemon installation requires sudo privileges. Please run with sudo.');\n    }\n    \n    logger.info('Installing Happy CLI daemon for macOS...');\n    await installMac();\n}","sourceCodeStart":1,"sourceCodeEnd":15,"githubUrl":"https://github.com/slopus/happy/blob/b824cd0a4681d41af631a8e422a813873e4455b0/packages/happy-cli/src/daemon/install.ts#L1-L15","documentation":"install() guards daemon installation to macOS only; on any other platform (linux, win32) it throws immediately before attempting the macOS-specific launchd install. The daemon implementation only exists for macOS (launchd plist via ./mac/install).","triggerScenarios":"Running `happy daemon install` (or the equivalent command) on Linux or Windows.","commonSituations":"Developer on a Linux/WSL machine tries to set up the daemon following macOS docs; CI runner on ubuntu attempts daemon install; user expects cross-platform daemon support that doesn't exist yet.","solutions":["Install/run the daemon on macOS only","Skip daemon installation on Linux/Windows and run happy in the foreground instead","Check the repo for Linux daemon support or file/track a feature request","On Windows use WSL only if a Linux daemon path exists — otherwise it is unsupported"],"exampleFix":"// before\nawait install(); // throws on linux/windows\n// after\nif (process.platform !== 'darwin') {\n  console.log('Daemon install requires macOS; running without daemon.');\n} else {\n  await install();\n}","handlingStrategy":"validation","validationCode":"if (process.platform !== 'darwin') {\n  console.log('Daemon install is macOS-only; skipping.');\n} else {\n  await install();\n}","typeGuard":null,"tryCatchPattern":"try {\n  await install();\n} catch (err) {\n  if (err.message.includes('only supported on macOS')) {\n    console.log('Run happy without the daemon on this platform.');\n  } else throw err;\n}","preventionTips":["Check process.platform before invoking daemon install","Only follow macOS docs on macOS machines","Feature-detect daemon support rather than assuming","Avoid daemon install in Linux CI runners"],"tags":["daemon","platform","unsupported"],"backgroundTag":"platform-not-supported","analyzedSha":"b824cd0a4681d41af631a8e422a813873e4455b0","analyzedAt":"2026-08-31T23:12:36.205Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T05:18:18.240Z"}