Hyperclay
  1. Hyperclay
  2. Guide
  3. Work on your computer

Work on your computer

Edit and run malleable documents on your computer using Hyperclay Local for two-way folder sync or HTML Clay for standalone local files.

Every malleable document is a standard .html or .htmlclay file that you own. If you open a downloaded document directly in a web browser from a file:// path, the page renders in view mode, but the browser cannot write changes back to your disk on its own.

To edit and save malleable documents on your computer (macOS, Windows, or Linux), use one of two free desktop apps: Hyperclay Local or HTML Clay.

When to pick which#

  • Pick Hyperclay Local when you want to work on a folder of documents and uploads in a local workspace window, edit files in your own desktop code editor, or sync folders in both directions with your personal and team workspaces on hyperclay.com.
  • Pick HTML Clay when you want to double-click and edit individual .htmlclay files anywhere on your disk, completely offline and without connecting an account.

Sync folders with Hyperclay Local#

Hyperclay Local runs a local server for a folder on your computer and opens your files in the same workspace interface as Hyperclay’s dashboard.

You can run Hyperclay Local offline for free, or connect it to your Hyperclay account with a sync key:

  • Two-way live sync: Edits, new documents, uploads, nested folders, renames, moves, and deletions sync in real time between your computer and hyperclay.com.
  • Team folders: One sync key syncs your personal workspace and creates a separate local folder for each team where you are an owner or editor.
  • Offline reconciliation and conflict resolution: When you work offline, Hyperclay Local keeps automatic local backups of every save and reconciles your changes when you reconnect. If a file changed on both sides, sync shows the conflict and lets you pick which version to keep.
  • Use your own tools: Because your documents sit in a normal folder on disk (with .html or .htmlclay extensions), you can edit them in any desktop code editor or let local scripts and AI agents work on them.

Connect Hyperclay Local to your account#

  1. In Hyperclay, open the My account menu and click Generate sync key….
  2. In the Generate sync key dialog, generate a new key and click Copy key. Keep the key private; it is shown only once when created and expires after one year. (Generating a sync key requires an active paid plan, or an editor role on a team with a Maker plan.)
  3. Follow the Hyperclay Local quick start and Sync with hyperclay.com to install the app and paste your sync key.

Open single files with HTML Clay#

HTML Clay is a desktop app for opening, editing, and saving standalone .htmlclay documents on macOS, Windows, and Linux.

  • Double-click to open: Open any .htmlclay file from Finder or File Explorer like a regular document. Plain .html files can also be opened read-only with their stylesheets, scripts, and images.
  • Local version history: Every save writes back to the file on disk and records a local version you can browse and restore.
  • Self-contained assets and Tailwind: Upload files into a folder beside the document, build Tailwind CSS locally from a single link tag with no build step, and export a document and its attachments as a portable zip.

To get started with standalone local files, read the HTML Clay quick start. To download documents from your Hyperclay workspace to open on your computer, see Import and export.