warp-diag

Generate a Zip file with information about the system configuration and the WARP connection

$ warp-diag

$ warp-diag --add-ts

$ warp-diag --output [path/to/directory]

$ warp-diag feedback

warp-diag [--upload] [--no-upload] [--output <FILE>] [--help] [-V, --version]

--upload
    Upload diagnostics to Warp servers and print shareable URL (default interactive)

--no-upload
    Save diagnostics locally without upload (default non-interactive)

--output <FILE>
    Custom output file path (default: warp-diag-<timestamp>.tar.gz)

--help
    Display help information

-V, --version
    Print version information

The warp-diag command is a utility bundled with the Warp Terminal for Linux, designed to simplify troubleshooting by generating a comprehensive diagnostic bundle. It collects essential data including Warp logs, configuration files, system information (CPU, memory, GPU), environment variables, shell history, and relevant system logs from journalctl. This bundle helps Warp support engineers reproduce and resolve issues efficiently.

By default, running warp-diag interactively prompts the user to upload the archive to Warp's servers, providing a shareable URL for support tickets. Non-interactive mode saves the tar.gz file locally. The tool respects user privacy by excluding sensitive data like passwords but includes potentially identifiable info like usernames and hostnames.

Ideal for reporting crashes, performance issues, or feature bugs in Warp, a modern GPU-accelerated terminal written in Rust. It runs quickly (under 30 seconds typically) and requires no root privileges, operating in the user's context. Output filename defaults to warp-diag-<timestamp>.tar.gz. Supports customization via flags for targeted diagnostics.

Requires Warp Terminal installed; collects user data (review bundle before sharing); not for production data leaks; Linux-only via Warp package.

warp-diag --upload
Generates and uploads bundle, prints URL.

Bundle excludes passwords/session tokens; manually inspect tar.gz contents if concerned.

Introduced in Warp Terminal Linux beta (2023) by Warp.dev to streamline support for their Rust-based terminal.

warp(1), warp-cli(1), journalctl(1)