← Back to Docs

Troubleshooting

Common issues and how to fix them.

WindOp won't launch

  • Try running as administrator
  • Check Windows Defender isn't quarantining the app
  • Reinstall from the latest release

API key errors

  • Verify your key at openrouter.ai
  • Make sure you have credits (free tier works)
  • Try re-entering the key in Settings

AI responses are slow

  • Switch to a faster model (Ctrl+M)
  • Check your internet connection
  • Smaller models respond faster — use them for simple tasks

File edits failed

  • Check file permissions — WindOp needs read/write access
  • Make sure the file isn't open in another program
  • For large files, use partial reads with startLine/endLine

Terminal commands not working

  • WindOp auto-detects the shell — try specifying PowerShell explicitly
  • Some commands need administrator privileges
  • WSL commands require WSL to be installed

Build from source fails

  • Ensure Node.js 18+ and Rust are installed
  • Run `npm install` before `npm run tauri dev`
  • Check the README for full prerequisites

Still stuck?

Open an issue on GitHub or join our Discord community.