Files and links

When an agent prints a web link or the path of a file on its Host, you can tap it to open it. Waycar also collects the images, PDFs, Markdown files, and links the terminal shows in a small strip under the terminal, and lists them all in Files & Links.

Open a link or a file from the terminal

• Tap a web link to open it in your browser, including a link that wraps onto the next line. On iPad, a click with a trackpad or mouse opens it too.
• Tap a file path such as ~/shot.png, src/app.swift:12:3, a bare shot.png, or report.pdf to preview it. Waycar fetches the file over SSH from the Host, relative to the terminal’s current folder.

Previews are read-only and only ever fetch the path you tapped. Common images (PNG, JPEG, GIF, HEIC, WebP), PDFs, text and source, and common audio and video open as themselves, .m4v videos included; anything else shows as plain text. Files over 25 MB, folders, and missing files say so instead.

The files and links strip

Waycar keeps the newest 25 files the agent printed in a small strip in the status row under the terminal. Images show as thumbnails; PDFs and Markdown files show as icons and are only fetched when you open one. Web links join the strip as one link tile after the files. The terminal never changes size for the strip.

Tap the strip to open Files & Links:

• Files: every file, newest first, with its folder.
• Links: every link, newest first, with its host and full address.

Tap a Markdown file to read it rendered, an image or PDF to see it full screen, and a link to open it in your browser. If a link can’t open, tap Copy Link. Touch and hold a link to copy it.

Read Markdown files

A Markdown file such as docs/plan.md or a bare README.md opens rendered: headings, lists and checklists, tables, code blocks, and quotes. Tap Show Raw Text to see and select the plain text, and Show Rendered to switch back. Waycar remembers which you picked.

Inside the file, a web link asks first, then opens in your browser. A link to another file on the Host asks first, then opens it. A link to a heading scrolls to it. Images are never loaded; each shows as a placeholder with its description. A file over 1 MB opens as plain text.

Why does Waycar ask before opening a link?

When a link’s text is not where it leads, Waycar shows the real address first, with Open (or Preview for a file on the Host), Copy, and Cancel. That covers a hyperlink printed under other words, a file: link, a path that climbs out of a folder with .., and a web address hiding a user name or unusual characters in its host.

Save to Photos

In the share menu of an image or video you opened from the terminal, Save Image and Save Video ask to add it to your photo library.