Skip to content
CortexDocs

Manage Defender

Start or stop Defender, manage individual capture paths, review workspace identity, and use update, policy, and diagnostic controls.

Open Settings from the Defender sidebar.

Start or stop Defender

Turn Defender off

  1. Open Danger zone. Select Stop Defender and review the confirmation.
  2. Confirm the stop and wait for Off. Follow a recovery instruction if shown; Retry refreshes a stale or unknown state.
  3. Restart affected CLI tools when requested and test direct provider access separately.
Stop Defender from Settings Danger zoneManage devices in Cortex

Stopping restores managed coding-agent settings and stops the local runtime and sync. No new activity is captured while stopped. This does not uninstall Defender or delete existing records. Browser routing and certificate trust have separate controls.

Turn Defender on again

  1. In Danger zone, select Start Defender and wait for On.
  2. Review Home. Starting reapplies configured coding-agent settings, so restart an affected app when requested.
  3. Start a new session and verify capture and sync.
Start Defender from Settings Danger zoneManage devices in Cortex

Pause or disconnect one app

Open the app under Connected on Home:

  • Pause sync pauses a desktop sync source; Pause import pauses a history source. Review the confirmation. These do not restore app configuration.
  • Disconnect restores a CLI's connection settings. Start a fresh session if requested and test direct access.

Other sources keep their own state. Local MCP is managed with your Cortex team. See Manage app connections.

Routing and certificate trust

On Home, open Browser sync, then Browser connections. Turn off routing does not remove trust or affect CLI connections. Remove certificate is separate and may require operating-system approval. Select Check health and test direct access with a fresh browser request.

Follow Set up browser sync for recovery, or Offboard or replace a device for removal.

Check for updates

In General, select Check for updates, wait for the result and follow any installation/restart instruction. Automatic updates controls installation. See Defender releases.

Reconnect your workspace

Workspace shows Organization domain and Email. The registered domain is read-only. Select Reconnect to sign in again; an unenrolled device offers Connect workspace.

Ask your admin about an incorrect identity or domain. A registered domain does not confirm sign-in or delivery. Verify a fresh capture after reconnecting.

Change device preferences

PreferencePurpose
AppearanceAuto follows the system; Light or Dark selects a theme.
Launch at loginStart Defender when you sign in.
Choose appearance and launch at loginManage devices in Cortex

If a setting cannot save, keep its current value and retry when available. Appearance does not change capture; pause or disconnect an app to manage a source.

Refresh policy

Under Gateway, select Sync policy while Defender is running. Read whether the policy is unchanged, updated or failed; retry a failed sync. This does not create budgets, rate limits or access rules.

Refresh Gateway policy from SettingsManage devices in Cortex

Get diagnostics help

Open Support → Share diagnostics, then Copy diagnostics. Wait for success; resolve a failed copy before sharing the clipboard. Review the details before sending them to support@chaoslabs.xyz, with the app, test time, expected result and actual result.

Share diagnostics from SupportManage devices in Cortex