Support > Troubleshooting and support
Sending feedback and logs
Send Warp feedback, bug reports, and feature requests, and gather logs, crash reports, CPU samples, and AI conversation IDs to attach to them.
Sending Warp feedback
Section titled “Sending Warp feedback”- Use the
/feedbackslash command inside Warp to open the static feedback experience. - Open a new bug or feature request in our GitHub repository.
- Join our Warp Community Slack and share feedback in #feedback-general, or #feedback-preview if it is specific to Warp Preview.
- For security issues or questions, email security@warp.dev.
- For questions about privacy, email privacy@warp.dev.
Subscribers and Enterprise
Section titled “Subscribers and Enterprise”- For subscriber technical issues or questions (bugs, credits, etc.), email support@warp.dev.
- For subscriber billing issues or questions (refunds, cancellation, etc.), email billing@warp.dev.
- For enterprise, please direct all feedback and issues to your designated Slack channel.
Using /feedback in Warp
Section titled “Using /feedback in Warp”The /feedback slash command is the fastest way to report a Warp bug, flag a regression, or file a feature request from inside the terminal. It opens the feedback form without starting an Agent conversation or consuming credits.
What to include
Section titled “What to include”Whether you use the /feedback slash command or file an issue manually, a good feedback report answers these questions up front:
- What happened? Describe the observed behavior in one or two sentences.
- What did you expect? Describe the behavior you expected instead.
- How do we reproduce it? List numbered steps when possible. If you can’t reproduce the issue reliably, mention that too.
- What version of Warp are you on?
/feedbackfills this in automatically; for manual reports, copy it from Settings > Account. - Logs, screenshots, or conversation IDs. See Gathering Warp logs, Collecting crash reports on macOS, or Gathering AI conversation ID below.
See the Slash Commands reference for the full list of commands available in Warp.
Gathering Warp logs
Section titled “Gathering Warp logs”Retrieve Warp’s logs by following the instructions for your platform below. Locate the log file and attach it to your GitHub issue or email.
The Warp log files are located at ~/Library/Logs/.
Warp logs on macOS
Run the following to zip the Warp logs to your Desktop:
zip -j ~/Desktop/warp-logs.zip ~/Library/Logs/warp.log*Warp Preview logs on macOS
Run the following to zip the Warp Preview logs to your Desktop:
zip -j ~/Desktop/warp_preview-logs.zip ~/Library/Logs/warp_preview.log*The Warp log files are located at $env:LOCALAPPDATA\warp\Warp\data\logs\.
Warp logs on Windows
Close Warp and run the following from another terminal to zip the logs to your Desktop:
Compress-Archive -Path "$env:LOCALAPPDATA\warp\Warp\data\logs\warp.log*" -DestinationPath "$([Environment]::GetFolderPath('Desktop'))\warp-logs.zip"Warp Preview logs on Windows
Close Warp Preview and run the following from another terminal to zip the logs to your Desktop:
Compress-Archive -Path "$env:LOCALAPPDATA\warp\WarpPreview\data\logs\warp_preview.log*" -DestinationPath "$([Environment]::GetFolderPath('Desktop'))\warp_preview-logs.zip"The Warp log files are located at ~/.local/state/warp-terminal/.
Warp logs on Linux
Run the following to zip the Warp logs to your home directory:
(cd ~/.local/state/warp-terminal && tar -czf ~/warp-logs.tar.gz warp.log*)Warp Preview logs on Linux
Run the following to zip the Warp Preview logs to your home directory:
(cd ~/.local/state/warp-terminal-preview && tar -czf ~/warp_preview-logs.tar.gz warp_preview.log*)Collecting crash reports on macOS
Section titled “Collecting crash reports on macOS”If Warp crashes, macOS may generate .ips crash report files in ~/Library/Logs/DiagnosticReports/. Run the following to collect all Warp crash reports into a zip on your Desktop:
files=$(find ~/Library/Logs/DiagnosticReports -name "*.ips" -exec grep -l "dev\.warp" {} + 2>/dev/null) && [ -n "$files" ] && echo "$files" | xargs zip -j ~/Desktop/warp-crash-logs.zip || echo "No Warp crash reports found."Attach the resulting warp-crash-logs.zip to your bug report.
Collecting debug info on Windows
Section titled “Collecting debug info on Windows”Occasionally, the Warp team may ask you to provide debugging information on Windows OS in particular with one of the following:
# If Warp is in your PATH, Run:warp --dump-debug-info
# Otherwise you may need to use an absolute path and ...# Warp on Windows is installed for a single user, Run:& $env:LOCALAPPDATA\programs\Warp\warp.exe --dump-debug-info
# Warp on Windows is installed for all users, Run:& $env:PROGRAMFILES\Warp\warp.exe --dump-debug-infoCollecting CPU samples
Section titled “Collecting CPU samples”Certain conditions can cause Warp to use more CPU than expected or become unresponsive. Collecting a CPU sample while the issue is happening is the best way to report it. The sample provides the information the Warp team needs to identify and fix the root cause.
Collect a sample using the steps for your platform and attach it to a new GitHub issue.
- Reproduce the high CPU usage or unresponsiveness in Warp.
- While the issue is occurring, open Activity Monitor, select the Warp process, and click Sample Process.
- Save the resulting sample and attach it to your GitHub issue.
Install samply to record a CPU trace:
powershell -ExecutionPolicy Bypass -c "irm https://github.com/mstange/samply/releases/download/samply-v0.13.1/samply-installer.ps1 | iex"-
Find the Warp process ID:
Terminal window Get-Process *warp* -
Start recording, replacing
<PID>with the process ID from the previous step:Terminal window samply record -p <PID> -
Reproduce the issue that causes high CPU usage or unresponsiveness.
-
Press
Ctrl+Cto stop recording.samplyopens the profile in the Firefox Profiler in your browser. Click the upload icon in the top-right corner to generate a shareable link, then paste it into your GitHub issue.
Install samply to record a CPU trace:
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mstange/samply/releases/download/samply-v0.13.1/samply-installer.sh | sh-
Start recording the Warp process:
Terminal window samply record -p $(pgrep -f warp-terminal) -
Reproduce the issue that causes high CPU usage or unresponsiveness.
-
Press
Ctrl+Cto stop recording.samplyopens the profile in the Firefox Profiler in your browser. Click the upload icon in the top-right corner to generate a shareable link, then paste it into your GitHub issue.
Gathering AI conversation ID
Section titled “Gathering AI conversation ID”To gather the conversation ID, RIGHT-CLICK on the AI conversation block in question and select “Copy conversation ID”, then paste that into the bug report that you submit so that our team can investigate the issue.
Whenever there is an error in the Agent Conversation, there will also be an option to directly copy the conversation ID for the bug report.
Using /copy-debugging-id
Section titled “Using /copy-debugging-id”The /copy-debugging-id slash command copies the same information without leaving the input. It works in both the Warp app and the Warp Agent CLI, and it applies to the conversation you’re currently in:
- Run
/copy-debugging-idin the conversation you want to report. - Warp confirms with a “Debugging information copied to clipboard” message.
- Paste the copied text into your bug report.
The copied text is a small JSON payload with the conversation ID, plus the request ID when the command is run on a specific agent response — for example, {"conversation_id":"abc123"}. If the conversation hasn’t reached Warp’s servers yet, the command reports that no debugging ID is available; send a prompt first, then run it again.
