Open With · Hyperclay Local docs

Hyperclay Local registers with your operating system as an alternate handler for .html (HTML Document) and .htmlclay (HTML Clay Document) files. Because it registers as an alternate rather than replacing your default browser, it appears in the Open With menu in Finder on macOS, File Explorer on Windows, and your file manager on Linux.

Open a document from your file manager#

Right-click an .html or .htmlclay file inside your personal folder or one of your synced team folders.
Choose Open With > Hyperclay Local (or pass the file path to the Hyperclay Local executable from the command line).

When the file is inside one of your served folders, Hyperclay Local:

Starts that folder’s local server if it is not already running.
Opens the workspace window directly to that document.

Messages when a file cannot open#

If the file you open cannot be served from its current location, Hyperclay Local shows a dialog explaining why:

Situation	Dialog message	Buttons and what to do
File is outside all Hyperclay Local folders	`<name>` is outside your Hyperclay Local folders. (“Hyperclay Local serves your personal folder and your team folders. Move the file into one of them to open it here.”)	Click Show Personal Folder to reveal your personal folder and move the file into it, click Open in HTML Clay (shown when HTML Clay is installed on your computer) to open the standalone file there, or click OK.
File is inside a hidden folder	Files inside hidden folders are not served.	Move the file out of the dot-folder (such as `.hyperclay/` or `.trash/`) into a normal folder inside your personal or team folder, then open it again.
The folder’s local port is in use	Port `<port>` is in use by another program. (“Fix it from the folder’s card, then open the file again.”)	Open the Hyperclay Local popover, free the port and click Retry (or click Use port `<nextPort>`… on a team folder), then open the file again. See Folders and ports.