A link in Oysterun can open a file, a folder, an Oysterun Website, another Oysterun screen, or an external website. The destination comes from the link target—not from a filename extension. This guide shows what to expect before you open each kind of link and how to return to the Session where you found it.

1. Start from a link you recognize

Session message with recognizable task-owned link targets.
Visible checkpoint: Session message with recognizable task-owned link targets.

Starting screen: the intended Session chat with its header and composer visible, and a message containing a visible link label.

Before selecting the link:

  1. Confirm the Session name in the header.
  2. Read the sentence around the link. The visible label and surrounding message should describe the destination you expect.
  3. Do not open a link whose sender, label, or purpose you do not recognize.

2. Predict where the link should open

This table covers the current Oysterun Host web UI. It does not use native-app controls as the prediction for a desktop or phone browser.

A local .html file is still a file and opens in File Preview. Only an Oysterun Website route under /sites/... opens as a Host-served Website page.

Local file link confirmed without exposing its parent path.
Visible checkpoint: Local file link confirmed without exposing its parent path.
File Preview showing task-owned content at a publication-safe temporary path.
Visible checkpoint: File Preview shows the task-owned note and its publication-safe temporary path.

Local links use a two-step confirmation because even a filename can identify private Host content. For a current agent-relative target, the visible link may already be the basename, such as tutorial-note.txt. The first selection confirms or expands that basename without revealing parent folders or a project path.

  1. Select the local file or folder link once.
  2. Read the confirmed basename. Compare it with the surrounding message and the file or folder name you expected; do not expect an absolute path to appear.
  3. If the basename and message are sufficient to identify the intended target, select the expanded link one time.
  4. Confirm that a file opened in File Preview or a folder opened in Explorer in a separate browser tab or window.

If the basename is wrong, or if you need the parent project path to distinguish the target, press Escape or select an empty part of the message to collapse it. Stop without opening the target and ask the sender to identify the project or provide a clearer link.

  1. Select the visible Website link once.
  2. In a desktop or phone Host browser, confirm the destination opened directly in a separate browser tab or window and shows the expected Website address.
  3. Wait for that destination. Do not select the source link again merely because the new tab is still loading.

A missing or malformed Website can show a friendly unavailable or 404 page. That means the route was handled safely; it does not make a missing page appear.

Oysterun screen link

Select a trusted /app/... link once. In a desktop or phone Host browser, it opens another Oysterun screen in a separate browser tab or window. An unknown Oysterun screen stays within Oysterun's route handling instead of being guessed as a local file.

Select an external web link only when you trust the sender and destination. Your desktop or phone browser applies its normal external-link policy. Stop at any certificate, sign-in, download, or security warning you did not expect.

5. Return to the source Session

Original Session restored with its source message and composer visible.
Visible checkpoint: the original Session, source message, and composer are visible again.

Oysterun can leave an unsupported local path as plain text or show an unavailable state. This is a safety result, not a reason to bypass the product route.

  1. Check that you selected the intended visible label.
  2. For a local link, compare the confirmed basename with the expected file or folder name. If you need the parent project path, collapse the link and stop.
  3. If a local target moved, ask for a new link from its current location or open the known folder through Explorer.
  4. If a Website shows 404, check the Website project and page name with the sender.
  5. If the destination is still unclear, close it and return to the source Session.