# HTML Clay docs

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

Source: https://htmlclay.com/docs/

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](https://clayjs.com/docs/), the free, open-source browser library that turns an HTML file into a malleable document. To make your own, read [Making malleable documents](https://htmlclay.com/docs/making-malleable-documents/) and see a [complete document explained line by line](https://clayjs.com/docs/guide/walkthrough/) in the ClayJS docs.

## Where to go next

- [Quick start](https://htmlclay.com/docs/guide/quick-start/): Install HTML Clay and open your first self-saving file in a few minutes.
- [AI editing](https://htmlclay.com/docs/guide/ai-editing/): Select a phrase, ask your AI agent to rewrite it, and keep the change in your file.
- [Let a program edit your file](https://htmlclay.com/docs/guide/let-a-program-edit/): Connect a document to a program or terminal agent that edits the file on disk.
- [Backups](https://htmlclay.com/docs/guide/backups/): See how HTML Clay backs up your files and how to restore an earlier version.
