Skip to main content

​
Overview

The scripts are designed to be executed on end-user devices through your MDM (Mobile Device Management) platform. They configure each AI coding tool to route through the Novageness Gateway.
All scripts must be run as root (or with administrator privileges) — each one checks for it and exits with This script requires administrator/root privileges otherwise.The commands below are written with sudo so they work when you run them by hand. Your MDM provider already executes in a root context, so drop the sudo prefix when you paste them into a deployment profile.
Before deploying, ensure your MDM provider is connected or devices are imported and you have an admin API key from gateway.novageness.com/connect.
In every command below, replace the following placeholders with your actual values:
  • YOUR_ADMIN_API_KEY — an admin API key from gateway.novageness.com/connect
  • https://backend.novageness.com — if your organization uses a custom backend URL, replace this with your own

​
Cursor

Run the following command to configure Cursor:

​
Claude Code

Claude Code supports two deployment methods depending on how your organization uses Anthropic.

​
Method 1: Using API Key

Use this method to route all Claude Code traffic through the Novageness Gateway without requiring an Anthropic subscription on the device:

​
Method 2: With Anthropic Account

Use this method if the user already has an active Anthropic subscription. This configures hooks for tracking and analytics while preserving the existing Anthropic authentication:

​
Gemini CLI

Run the following command to configure Gemini CLI:

​
Codex

Codex supports two deployment methods depending on how your organization uses OpenAI.

​
Method 1: Using API Key

Use this method to route all Codex traffic through the Novageness Gateway without requiring an OpenAI subscription on the device:

​
Method 2: With OpenAI Account

Use this method if the user already has an active OpenAI subscription. This configures hooks for tracking and analytics while preserving the existing OpenAI authentication:

​
GitHub Copilot

Run the following command to configure GitHub Copilot. Hooks-based — works with both the VS Code extension and the copilot CLI on the user’s existing Copilot subscription:

​
Augment Code

Run the following command to configure Augment Code. Hooks-based — works with both the Augment VS Code extension and the Auggie CLI:

​
Remove Novageness Configuration

To remove the Novageness Gateway configuration from a device, run that tool’s mdm-install command with only the --clear flag. Clearing does not require an API key or backend URL. This removes all Novageness-related settings for that tool and restores it to its default state. For example, to clear Cursor:

​
Keep enforcement in place

Deploying through MDM installs Novageness as managed settings that standard users can’t remove. Schedule the deployment to run daily so enforcement stays resilient.

Tamper Resistance

Best practices for keeping Novageness active on every device with managed settings.