macOS

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 turen.io/download or the Downloads section of your Turen dashboard. The DMG is a single universal build that runs on both Apple Silicon and Intel Macs, so there is no architecture to pick. No registration key is required. Open the DMG and follow the installation prompts. If the installer offers a registration key field, you can leave it blank and register by signing into the desktop app instead (see below). Registration keys remain available for headless and fleet installs (generate one from Devices > Settings in the dashboard). The installer will:

Install turen-watchdog, turen-pkg, turen-batou, and turen-updater
Install the Turen desktop app
Configure Claude Code automatically via managed-settings.json (environment variables and hooks)
Start the agent as a background service (LaunchDaemon)

The desktop app and the agent auto-update together, so you do not update the desktop app separately.

Register This Machine

Open the Turen desktop app (from /Applications) and sign in or create an account. Signing in registers this machine with your organization over local IPC. No key or configuration is needed.

If your account has multi-factor authentication (an authenticator app / TOTP) enrolled, the desktop app prompts for the 6-digit code when you sign in. Both email/password and Google sign-in support MFA. You enroll and manage MFA factors in the dashboard under User Settings.

Using Claude Code

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-pkg
sudo rm -rf /usr/local/bin/turen-batou
sudo rm -rf /usr/local/bin/turen-updater
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.

Get Started

Installation

Dashboard

Security Rules

Developer Experience

Administration

Security

Troubleshooting

Requirements

Install

Register This Machine

Using Claude Code

Managing the Agent

Uninstall

Other Platforms

​Requirements

​Install

​Register This Machine

​Using Claude Code

​Managing the Agent

​Uninstall

​Other Platforms

Requirements

Install

Register This Machine

Using Claude Code

Managing the Agent

Uninstall

Other Platforms