Skip to main content

​
Requirements

  • macOS 13 (Ventura) or later
  • Apple Silicon (M1+) or Intel
  • Claude Code installed
  • Admin access (for installation)

​
Install

Download the Turen agent installer (.dmg) from the Downloads section of your Turen dashboard. You’ll need a registration key: generate one from Agent Settings > Registration Keys before starting. Open the DMG and follow the installation prompts. You’ll be asked to enter your registration key during installation. The installer will:
  • Install turen-watchdog, turen-proxy, and turen-pkg
  • Register the machine with your Turen organization
  • Configure Claude Code automatically via managed-settings.json (environment variables and hooks)
  • Start the agent as a background service (LaunchDaemon)
Once complete, open a new terminal and use Claude Code as normal: 
claude
No manual configuration is needed.

​
Managing the Agent

# Check agent status
turen-watchdog status

# Stop the agent
sudo launchctl unload /Library/LaunchDaemons/dev.turen.watchdog.plist

# Start the agent
sudo launchctl load /Library/LaunchDaemons/dev.turen.watchdog.plist

# View agent logs
log show --predicate 'subsystem == "dev.turen.watchdog"' --last 5m

​
Uninstall

# Stop the service
sudo launchctl unload /Library/LaunchDaemons/dev.turen.watchdog.plist

# Remove files
sudo rm -rf /usr/local/bin/turen-watchdog
sudo rm -rf /usr/local/bin/turen-proxy
sudo rm -rf /Library/LaunchDaemons/dev.turen.watchdog.plist
rm -rf ~/Library/Application\ Support/Turen

​
Other Platforms

Running Turen on Linux or Windows? See the Linux or Windows installation guides.