> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Files, Links, & Scripts

Quickly open links and files or run scripts with your mouse.

## 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](/terminal/more-features/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](#tab-panel-794)
-   [Windows](#tab-panel-795)
-   [Linux](#tab-panel-796)

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.

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.

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](/support-and-community/troubleshooting-and-support/sending-us-feedback/#sending-warp-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`)