HTML Clay
  1. HTML Clay
  2. Guide
  3. HTML Clay docs

HTML Clay docs

Open HTML files on your computer that save changes straight back to disk with HTML Clay, a free desktop app.

HTML Clay is a free, source-available desktop app for macOS, Windows, and Linux that lets HTML files on your computer save themselves. Double-click a .htmlclay file to open it in your browser, switch to Edit, and your changes save straight back to disk. There is no account and no cloud, and the file never leaves your computer.

Why HTML Clay exists#

Reusable, portable, free, open-source software that anyone can use and improve on their own needs a lightweight visual and data format. The HTML file is a natural choice because it gives you the full web platform in one file.

Normally, an HTML file opened from disk cannot save changes back to itself. We built a system around the HTML file so you can update it like a web application, both on the web and on your own computer. Your edits stay inside the file on disk, so you can move it, back it up, or email it around as a portable file.

What people do with HTML Clay#

  • Answer questions from an AI agent: Your AI agent creates a form to ask you questions. You fill out the form in your browser, and your answers save into the file so you never lose them.
  • Give visual feedback on screenshots: Mark up screenshots with a feedback tool built into the document. Your notes stay in the file, and your AI agent reads them straight from the HTML.
  • Run project dashboards: For multi-week projects, your AI agent builds a dashboard and updates it through the document’s JSON API.
  • Keep a daily work journal: Track client work, to-dos, finished tasks, and plans for new projects in one file.
  • Draw diagrams: Sketch and edit diagrams that save directly inside the document.

A lot fits into these simple documents, and every file stays under your control.

Making your own HTML Clay files#

Most HTML Clay files are made with ClayJS, the free, open-source browser library that turns an HTML file into a malleable document. To make your own, read Making malleable documents and see a complete document explained line by line in the ClayJS docs.

Where to go next#