macOS
Desktop package
Use the supplied pkg installer to install Timon in /Applications and make the timon terminal command available without Node.js. The DMG also remains available; see CLI setup to add its terminal command manually. Open Timon and follow First run. The setup flow checks tools and installs a launchd agent so that agent work can continue after the window closes.
From an authorised source checkout
Run these commands from the root of the Timon checkout:
cd orchestrator
npm ci
npm run build
npm run install:cli
cd ../app
npm ci
npm run build
cd ..
The CLI installer puts timon in ~/.local/bin; follow its PATH instructions. Set daemon.installDir to the absolute path of this checkout's orchestrator directory, following Configuration. Enable app.enabled to let the daemon serve the built app without Docker.
Inspect the service installation before applying it:
timon service install --dry-run
timon service install
timon service status
timon doctor
The launchd label is com.timon.daemon; its plist lives in ~/Library/LaunchAgents/. Use an explicit backend binary path when launchd cannot find a tool that works in your shell.
Open the configured web-app address (for the configuration example, http://127.0.0.1:3100) and complete First run.
Installing or changing a daemon service is an operator action. Finish active missions first, and do not overwrite a service belonging to another checkout or data directory.