Files, Links, & Scripts

Files & links

Warp supports opening files, folders, and URL links that are within Blocks. Multiple URL protocols are supported e.g. https, ftp, file, etc. Warp can open files and folders in a variety of editors and opens web links directly in your default browser. Warp can also open markdown files directly with a Markdown Viewer.

Note

Warp also supports iTerm2 and Kitty Image protocols on macOS and Linux. You will need to use a CLI tool to view images, in some cases the tools expect $TERM=kitty, so you may need to workaround this by setting TERM=kitty before the command. We’re working on updating the popular tools to recognize Warp natively.

Warp parses relative and absolute file paths. Warp also tries to capture line and column numbers attached to the file path, supported formats include:

• file_name:line_num
• file_name:line_num:column_num
• file_name[line_num, column_num]
• file_name(line_num, column_num)
• file_name, line: line_num, column: column_num
• file_name, line: line_num, in

macOS

1. After hovering over a link, open it directly by holding down CMD while clicking it.
2. Clicking a link normally will open a clickable tooltip that says “Open File/Folder/Link”.
3. Right-clicking a link will open a context menu that supports copying the absolute file path or URL to the clipboard.

Windows

1. After hovering over a link, open it directly by holding down CTRL while clicking it.
2. Clicking a link normally will open a clickable tooltip that says “Open File/Folder/Link”.
3. Right-clicking a link will open a context menu that supports copying the absolute file path or URL to the clipboard.

Linux

1. After hovering over a link, open it directly by holding down CTRL while clicking it.
2. Clicking a link normally will open a clickable tooltip that says “Open File/Folder/Link”.
3. Right-clicking a link will open a context menu that supports copying the absolute file path or URL to the clipboard.

• You can also Drag and drop a folder or file onto the Warp dock icon to open a new tab in this directory.
• You can also right-click on a folder or file in Finder, then select Services, and “Open new Warp Tab | Window here”.
• Configure the default editor to open files by navigating to Settings > Features > General > Choose an editor to open file links.
  • Selecting “Default App” uses your system’s default application for the file type.

OSC 8 hyperlinks

Warp supports OSC 8 hyperlinks, the terminal escape sequence that lets a command attach a destination URL to a run of text. Tools that emit OSC 8 — ls --hyperlink=auto, gh, delta, many test runners and linters — render as clickable link text in Warp instead of printing a raw URL, so output stays readable and the destination stays one click away.

OSC 8 links behave like the URLs Warp detects in output: hover the link text, then modifier-click it to open it (CMD on macOS, CTRL on Windows and Linux), or click it once to get the Open link tooltip. Right-click the link text for a context menu with Open link and Copy link, which copies the destination URI rather than the visible text.

Emitting an OSC 8 hyperlink

The sequence takes the form OSC 8 ; params ; URI ST, and an empty URI closes the currently open link:

printf '\e]8;;https://docs.warp.dev\e\\Warp docs\e]8;;\e\\\n'

This prints the text Warp docs linked to https://docs.warp.dev.

Behavior and limits

• Valid URLs only - Terminal output is untrusted, so Warp opens a hyperlink only when its URI parses as a valid URL. A link with a malformed destination stays inert.
• URI length cap - A URI is capped at 2083 bytes, matching the cap used by other terminals. Longer URIs are dropped.
• id parameter - Warp parses the spec’s id parameter (up to 256 bytes) but treats it as a hint. Oversized or invalid ids are ignored, and the link stays clickable.
• Malformed sequences close the link - A malformed, non-UTF-8, or over-length sequence closes any open hyperlink, so unrelated output that follows can’t inherit a stale destination.
• Semicolons in URIs - Warp reassembles URIs that contain ; (matrix parameters, session ids, percent-encoded payloads), so those destinations survive intact.

List of supported editors

Non-exhaustive list of editors, please submit new ones on our GitHub, see Sending Feedback.

1. $EDITOR
2. Visual Studio Code
3. JetBrains IDEs
   • WebStorm
   • PhpStorm
   • GoLand
   • PyCharm
   • DataGrip
   • DataSpell
   • Rider
   • RubyMine
4. Zed and Zed Preview
5. Cursor
6. Windsurf
7. Sublime Text
8. Android Studio

Scripts

Warp can open .command and Unix Executable files from Finder directly.

1. Find a .command or shell script you’d like to open in Finder.
2. Right-click and open the script with Warp.

Caution

Make sure the file has the appropriate executable permissions before you can run it in Warp. (e.g. chmod +x script.command)