Troubleshooting

Clipboard copy and paste not working

Installing an extra tool might be needed on Unix-like environments.

Environment	Tool
Windows	Native support
macOS	Native support
Linux/BSD + Wayland	wl-copy and wl-paste
Linux/BSD + X11	xclip or xsel

Common Issues

Crush can't find my provider

Make sure the corresponding environment variable is set. See the environment variables reference for the full list.

LSP isn't providing context

Ensure the LSP is configured in crush.json and the language server binary is on your PATH. Enable debug_lsp for more information:

{
  "options": {
    "debug_lsp": true
  }
}

MCP server won't connect

Check that the server URL or command is correct and that any required authentication headers or environment variables are set. See MCPs for configuration details.

Logs aren't showing enough detail

Run Crush with the --debug flag or enable debug mode in your config:

{
  "options": {
    "debug": true
  }
}

Logs are stored in ./.crush/logs/crush.log relative to the project.

Getting Help

Need more help? Find us on:

• Slack
• Discord
• Twitter