Agent Detection Troubleshooting

If UnfoldAI isn't detecting your AI coding agent, follow these steps.

Verify UnfoldAI Is Active

• The UnfoldAI icon should be visible in the Activity Bar (left sidebar)
• The status bar should show an UnfoldAI indicator at the bottom of VS Code
• Open the UnfoldAI sidebar and confirm the Dashboard loads

Check VS Code Version

UnfoldAI requires VS Code 1.93 or later for full shell integration. Check your version: Help → About.

Use the UnfoldAI Terminal

The UnfoldAI Terminal (Ctrl+Shift+U / Cmd+Shift+U) provides the most reliable command tracking. Try running your agent from this terminal.

Enable Debug Logging

Set the attribution log level to debug for detailed detection information:

{
  "unfoldai.attribution.logLevel": "debug"
}

Check the Output panel (View → Output) and select "UnfoldAI" from the dropdown.

Custom Agent Fingerprints

For agents UnfoldAI doesn't recognize by default, add custom fingerprints:

{
  "unfoldai.agentFingerprints.override": {
    "your-agent-name": {
      // Custom identification rules
    }
  }
}

Supported Agents

UnfoldAI ships with built-in detection for:

Agent	Detection
Cursor	Automatic
Claude Code	Automatic
GitHub Copilot	Automatic
Cline	Automatic
Continue	Automatic
Codeium / Windsurf	Automatic
Any terminal-based agent	Automatic (file + terminal monitoring)