Installation
Install AI Code Insights on one macOS, Windows, or Linux machine and verify a known commit. Use this path for individual installs; use Enterprise deployment for a managed rollout.
Note: Install the daemon on the machine where the code lives. For remote SSH or dev-container workflows, install it inside the remote environment. WSL requires systemd and a working systemd user manager.
Before you begin
- DX access: A Data Cloud admin must enable AI Code Insights and make the installer available for your account.
- A monitored repository: The repository must be imported through a supported source control connector.
- A supported environment: macOS uses a universal package for Intel and Apple silicon. Windows supports AMD64. Linux supports Debian- and Red Hat-based distributions on AMD64.
- A supported coding agent: See supported agents.
Step 1: Enable
Go to Admin → AI Code Insights and enable the feature. Download the installer for the developer’s operating system.
Step 2: Install
Run the downloaded universal .pkg. The package selects the Intel or Apple silicon binary for the machine, installs it at /usr/local/bin/aicodemetricsd, creates a per-user LaunchAgent, starts the daemon, and installs integrations for detected coding agents. It also installs a root-owned updater helper as a system LaunchDaemon.
If the monitored repositories are under Desktop, Downloads, Documents, or another protected directory, grant Full Disk Access to /usr/local/bin/aicodemetricsd under System Settings → Privacy & Security → Full Disk Access.
Run the downloaded AMD64 .msi. The installer places the daemon and the aicodemetrics.cmd command wrapper under %ProgramFiles%\AICodeMetrics, creates a Scheduled Task for the logged-in user, starts it, and installs integrations for detected coding agents. It also installs a privileged updater helper as an on-demand Scheduled Task.
Extract the downloaded archive and run the installer from the extracted directory:
tar -xzf <downloaded-archive>.tar.gz
./install.shThe installer places aicodemetricsd under /usr/local/bin and creates a systemd user service. It uses sudo to write the binary, enable user-service linger, and install the updater helper as a root system service.
The installer preserves existing configuration and local data when it replaces an earlier version.
Step 3: Sign in
Run the login command unless your organization delivered credentials through managed configuration.
aicodemetricsd login& "$env:ProgramFiles\AICodeMetrics\aicodemetrics.cmd" loginOn Windows, use aicodemetrics.cmd for commands you run in PowerShell. The wrapper waits for the daemon command to finish so interactive prompts receive your input. If the wrapper is missing, run the current MSI over the existing installation; no uninstall is required.
Choose the browser flow to sign in to DX and save the API URL, token, and email. Choose manual entry when the browser flow is unavailable and use the API URL and token from Admin → AI Code Insights.
For manual or managed settings, see Configuration reference.
Step 4: Verify
aicodemetricsd status& "$env:ProgramFiles\AICodeMetrics\aicodemetrics.cmd" statusThen complete Verify deployment with one monitored repository and one known commit.
Data appears after the daemon detects a pushed commit on a remote branch. Session data appears after the coding-agent integration emits a stop, compact, or end event.
Automatic updates
Automatic daemon updates are available on macOS and Windows with AI Code Insights 0.7.0 or newer, and on Linux with 0.7.2 or newer. Linux requires systemd and a working systemd user manager.
If you installed AI Code Insights on Linux before version 0.7.2, download the current Linux .tar.gz, extract it, and run ./install.sh from the newly extracted directory once. This installs the fixed updater helper required for automatic updates. Replacing only the daemon binary does not update the helper.
Automatic updates are off by default. Under Admin → AI Code Insights → Automatic daemon updates, turn on Enable auto-updates. This setting applies to all eligible daemon installations in the account and cannot be overridden through local or managed configuration.
The daemon fetches this setting and checks for a newer release after startup and every hour. Each check can be delayed by up to 10 minutes to spread downloads across the organization. When an update is available, the daemon downloads the platform package, asks the privileged updater helper to verify and activate it, and restarts. If the updated daemon does not start and confirm the new version within three minutes, the helper restores the previous version.
Run status to see whether automatic updates are enabled and whether an update is pending or failed.
Existing macOS and Windows installations from before version 0.7.0 must run the current installer once to add the updater helper.
Automatic updates replace only the daemon binary. They do not install or update the Windows aicodemetrics.cmd wrapper, the updater helper, or other installer-managed components. Redeploy the current installer when you need to add or update those components.
To update manually, download the current installer from Admin → AI Code Insights and run it over the existing installation. No uninstall is required. The installer preserves configuration and local data and restarts the service.