Skip to content
CortexDocs
Defender · Troubleshooting

Defender troubleshooting

Troubleshoot Defender connections, capture, and workspace sync, then send diagnostics to the Chaos Labs team if it still does not work.

Updated
Try the recommended action
  • Follow the shown actionStart with the action shown in Health
  • Run health checkConfirm AI connections recover
  • Send diagnosticsEscalate with useful context
Find which part needs attention
01ConnectionIs the source connected?
02CaptureWas activity captured locally?
03SyncHas activity reached the workspace?
Follow the matching troubleshooting pathUse the app state and the observed symptom.
Start with the symptom, then check the connection, capture and sync states. Use the matching troubleshooting steps rather than assuming all missing activity has the same cause.

If Cortex Defender is not working, open Home → View health and follow the recommended action. If the problem continues, copy diagnostics and contact the Chaos Labs team.

Try the recommended action

  1. Open Home → View health.
  2. If a connection needs attention, follow its Next step, such as Repair Claude Code.
  3. Select Run health check.
  4. Restart an app or browser only if Defender asks you to.
  5. Send a new prompt and verify capture and sync.
Repair a connection that needs attentionManage devices in Cortex

Send diagnostics

  1. Open Home → View health.
  2. Select Copy diagnostics.
  3. Send the diagnostics to the Chaos Labs team at ai-support@chaoslabs.xyz with:
    • The source you were using
    • The approximate time of the test
    • What you expected to happen
    • What happened instead

Copying diagnostics does not send them to support. Review the copied details before sharing them.

Local port conflicts

If the error names a local port or process, include those details when you contact the Chaos Labs team.

Developers running local services can use Fix Cortex Defender port conflicts.

Where to check status

DestinationUse it for
HomeCheck whether Defender is on, off, or changing state
Home → View healthCheck Defender, app connections, workspace sync, and device status
Health → Next stepFollow the repair action for a reported issue
Connections → appManage the app's connection, check it, and review Last activity seen
Connections → Browser settingsManage Web routing, Certificate trust, and browser launch actions
SettingsReview workspace and device preferences
Cortex Atlas → user profileConfirm that captured activity reached the workspace
Was this helpful?

On this page

Try the recommended actionSend diagnosticsLocal port conflictsWhere to check status