Common Issues

UnfoldAI Not Detecting My Agent

Symptoms: Dashboard shows no agent activity despite running an agent.

Solutions:

1. Verify UnfoldAI is activated — you should see the UnfoldAI icon in the Activity Bar
2. Check that you're running VS Code 1.93 or later (shell integration improved significantly in this version)
3. Try using the UnfoldAI Terminal (Ctrl+Shift+U / Cmd+Shift+U) for more reliable capture
4. Check unfoldai.attribution.logLevel — set to "debug" temporarily to see detection logs

Dashboard Shows "No Activity"

Symptoms: Activity feed is empty.

Solutions:

1. Agent activity may not have started yet — run a command in your AI agent
2. If using a standard VS Code terminal, switch to the UnfoldAI Terminal for better capture
3. Check the capture quality indicator — a "partial" rating suggests switching to UnfoldAI Terminal

AI Features Not Working

Symptoms: Commit messages, chat, or reports return errors.

Solutions:

1. Verify you're logged in (required for backend AI features)
2. Check if you've hit your tier's usage limits
3. Verify unfoldai.privacy.localOnly is not enabled (it disables all backend calls)
4. Check your internet connection — AI features require backend connectivity

MCP Server Not Connecting

See MCP Troubleshooting for detailed solutions.

Terminal Issues

Shell not recognized / no shell integration:

• cmd on Windows does not support shell integration hooks — use PowerShell or pwsh instead
• Verify your shell is supported: bash, zsh, fish (macOS/Linux), PowerShell/pwsh (Windows)

Terminal welcome banner is too verbose:

{ "unfoldai.terminal.welcomeMode": "compact" }

Or set to "hidden" to remove it entirely.