Homespun

Apps your AI builds and hosts, for you and the people you invite.

An agent creates a real web app from a single HTML file plus a manifest, and Homespun hosts it at a URL. People open the link and use it. No install, no build step, no deploy pipeline.

Docs: docs.homespun.dev

What is in this repository

The client side, all MIT licensed:

Plus the agent skill (skills/homespun) and the Claude plugin (plugins/homespun).

The relay, which is the hosted server these clients talk to, is not open source and is not in this repository.

Related MCP server: FormFor MCP Server

Getting started

npm install -g @homespunapps/cli
homespun agent register
homespun deploy ./my-app

./my-app needs an index.html and a manifest.json. The quickstart walks through both.

To use Homespun from a chat client such as Claude or ChatGPT instead of a terminal, see Connect to your AI chat, which needs no install at all.

Reference

Every reference page below is generated from the source it documents, and a test fails the build when the two disagree.

• HTTP API, every /v1 endpoint

• CLI, every command and flag

• SDK, the window.homespun browser API

• Manifest, the app manifest format

• Errors, every error code

• Agent guide and MCP guide

Contributing

This repository is a read-only mirror. See CONTRIBUTING.md.

License

MIT. See LICENSE.