HTML files

.html and .htm files open inside the app, shown the way a browser would show them. They are always read-only.

How to reach it

Open a tracked folder in the sidebar and click an HTML file's row, the same as any other file. You can also choose Open With in Finder and select Context Raven. On Windows, browse to the app if it is not listed. On macOS, you can use open -a "Context Raven" "/path/to/page.html" in Terminal. The file opens in a new tab, or activates its tab if it is already open. The app does not make itself your default HTML viewer.

Viewing

The file opens exactly as it is on disk, with its own styling and its own scripts, on a white page whatever the app's theme. Charts, tabs and other interactive parts built into the file work. Context Raven never writes to it: there is no editor, no Save and no Save As for it. To show it, the app adds one invisible tag in memory, before the page starts, so that links to places inside the file work — without it, such a link would load the app itself in place of the file. A file that sets its own base address is shown without it.

The file runs in an isolated frame. A script inside it cannot read the rest of the app, open a new window or navigate the app away. It can load scripts, images and fonts from the internet and contact servers the way a web page can, so what the file sends is decided by the file, not by Context Raven. It cannot embed another web page or replace itself with one.

On macOS and Windows, the page can show images in its own folder and subfolders. Its scripts can learn whether such an image exists and its dimensions, but cannot read its bytes. Images outside that folder are not accessible. On Windows, an image behind a symbolic link, junction or similar link inside the folder does not show, even when the link points inside that folder. An HTML file saved in your home folder or Downloads can show and probe for images anywhere below that folder, so keep pages you do not trust in their own folder.

If another program, a script, or an AI agent rewrites the file while you are viewing it, the app shows the new version.

An HTML file runs when you open it explicitly, including from outside the app. When an HTML tab was active at shutdown, startup opens the latest Markdown file if one exists; otherwise it shows an empty tab. A saved empty active tab stays empty. The HTML file stays in your tabs and recent files, ready to reopen. Adding a folder never opens an HTML file in it either.

The top bar keeps Copy content, Download, Copy file path, Move to Trash and the breadcrumb. There is no search button, no reading/editing toggle and no version rail.

In the sidebar

HTML files appear in the tree and in the "Last changed" list. Search finds them by file name only — the text inside an HTML file is not searched, because its tags and attribute names would match almost anything.

Limits

  • On macOS and Windows, relative images beside the HTML file or in its subfolders show in the preview. Supported types: PNG, JPEG, GIF, WebP, AVIF and SVG, up to 50 MiB per file. Paths that leave the HTML file's directory, including symlinks leading outside, are refused. Windows also refuses symbolic links, junctions and similar links inside the folder. Images behind those links do not show, even when their targets stay inside. Inline data: images continue to work.
  • Neighbouring stylesheets, scripts, fonts and data files (such as ./data.json) are not loaded. They would widen what the document can read beyond images.
  • Links that lead out of the file — to a website or another file — do not open. Links to a place within the same file work.
  • No find in document (⌘F) inside an HTML file.
  • No renaming, and no Share to cloud. Move to Trash, Reveal in Finder and Copy File Path still work.
  • No version history or View last changes for HTML files.
  • Extensions match regardless of case: .HTML, .HTM and mixed-case spellings are listed too.
  • A script in the file that never finishes freezes the app window until you quit it. The app does not reopen that file on the next start.

Having trouble loading?

The app seems stuck. This can happen after an update. Clearing the cache should fix it.