Homespun is aimed at scenarios where you want AI to directly build and host web apps that can be shared with others. According to the repository description, its core idea is: an AI agent generates a real web app from an HTML file plus a manifest.json, and Homespun hosts it at a URL; users can open the link and use it, with no installation, build step, or deployment pipeline required.
Main capabilities: support for deploying and operating multi-user web apps, including magic-link login, a shared real-time database, role-based permissions, email notifications, and file uploads.
What this repository contains (all released under the MIT license): the client CLI, MCP server, SDK core, as well as agent skills (skills/homespun) and a Claude plugin (plugins/homespun). The hosted server side (relay) is not open source and is not in this repository.
How to use it: the app directory ./my-app needs to contain index.html and manifest.json, and the quick start guide introduces these two parts. In addition to using it in the terminal, you can also use Homespun from chat clients such as Claude or ChatGPT; see "Connect to your AI chat," which does not require installation. Each reference page in the repository is generated from the source code it documents, and if the two are inconsistent, the build test will fail. Documentation you can refer to includes: HTTP API (every /v1 endpoint), CLI (every command and flag), SDK (window.homespun browser API), Manifest (app manifest format), Errors (every error code), Agent guide, and MCP guide. Documentation address: docs.homespun.dev. The repository is a read-only mirror.
Limitations and notes: the hosted server side is not open source; facts such as pricing, fees, and the specific scope of platform support are not yet provided.
