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.

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

OSC 8 hyperlinks

Warp recognizes the OSC 8 escape sequence, so command-line tools can print a short label that links to a longer URL instead of printing the raw URL. When a program emits an OSC 8 hyperlink, Warp renders only the visible text and makes it clickable, the same way it treats auto-detected URLs:

• Hold ⌘ (macOS) or Ctrl (Windows/Linux) and click the linked text to open it.
• Copying the block copies the visible text, not the escape sequence or the underlying URL.

Any URL scheme works, including file:// URLs without a hostname. To try it, print a hyperlink from your shell:

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

The output shows Warp docs as a clickable link. Plain-text URL detection still works, so tools that print full URLs behave as before.

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)