Skip to content

Troubleshooting

Harness edited this page May 20, 2026 · 6 revisions

Harness of AI logo

Troubleshooting

CLI daemon / IPC

Error Fix
CLI stdin is not writable Reload window; check Output → Harness for crash; reinstall VSIX
CLI ping timed out Daemon failed to start — check Node ≥ 20 on PATH
CLI daemon exited unexpectedly See stderr in Output; often bad token or uncaught exception

GitHub Copilot

Error Fix
HTTP 401 gh auth refresh --scopes copilot; reload VS Code
HTTP 404 on token exchange Use OAuth token with copilot scope; Business accounts may use token directly
Bad credentials Clear stale secret; use live gh auth token

Cursor AI

Error Fix
HTTP 404 from api2.cursor.sh Wrong endpoint — use https://api.cursor.com, not api2.cursor.sh
HTTP 401 Create key at cursor.com/dashboard/integrations
No response / stuck thinking Cursor Cloud can take minutes; Harness now shows status text and errors after 90s without text. Use Ask mode for simple chat. Open View → Output → Harness for [cursor] logs. + New chat if stuck.
read ECONNRESET in Agent mode Normal for long cloud-agent runs — Harness reconnects the SSE stream automatically. If it persists, + New chat or use Ask (Plan mode on Cursor). Rebuild VSIX after updates.
HTTP 409 agent_busy Previous Cursor run still active — + New chat, or wait a few seconds; Harness now cancels stale runs automatically

Claude

Error Fix
getGoat shows ready but CLI missing Install Claude Code CLI
Command not found Set harness.connectors.claude.path

Context / chat UI

Issue Fix
Clear does not remove messages Use Clear all (composer) or view title Clear Chat & Context; + New chat clears messages only (keeps context files)
Stop does not stop Ensure chat:cancel reaches daemon (check Output trace)

Logs

Always check View → Output → Harness first.

harness check getGoat    # CLI-side readiness

Clone this wiki locally