homespunapps/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:
| Package | What it is |
|---|---|
| @homespunapps/cli | The homespun command line client |
| @homespunapps/mcp | The MCP server, so an agent can drive Homespun as a tool |
| @homespunapps/core | Shared client library and types |
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.
Getting started
./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.