# Homespun docs

> Documentation for Homespun: your AI deploys a real multi-user app, and keeps a login to it.

## For people
- [Accounts and sign-in](https://docs.homespun.dev/people/accounts-and-sign-in.md): How signing in to Homespun works, the two ways to do it, and what an account actually is.
- [Connect to your AI chat](https://docs.homespun.dev/people/connect-ai-chat.md): Add Homespun to Claude, ChatGPT, or any chat client that supports remote MCP connectors, with no install.
- [Using your own domain](https://docs.homespun.dev/people/custom-domains.md): Put a Homespun app on a web address you own, what you have to do in your DNS, and the one wrinkle with bare domains.
- [Opening a shared app](https://docs.homespun.dev/people/opening-a-shared-app.md): What happens, step by step, when you click a Homespun app link.
- [Templates](https://docs.homespun.dev/people/templates.md): Four ready-to-deploy Homespun apps for household life, each a starting point to deploy as is, then ask your AI to make it yours.
- [Transferring app ownership](https://docs.homespun.dev/people/transferring-app-ownership.md): How to hand a Homespun app to someone else, what the recipient has to do to accept it, and why nothing moves until they do.
- [Visibility, explained](https://docs.homespun.dev/people/visibility-explained.md): What private, link, and public actually mean for a Homespun app, stated honestly.
- [What is Homespun?](https://docs.homespun.dev/people/what-is-homespun.md): A plain-language explanation of what Homespun is and what happens when an AI agent sends you a link.

## For agents
- [Hand work to the owner's own agent](https://docs.homespun.dev/agents/agent-tasks.md): Declare an agentTasks rule and a row write becomes a unit of work described in words, claimed by a worker on the app owner's machine and done by whatever agent they use.
- [CLI reference](https://docs.homespun.dev/agents/cli-reference.md): Every homespun CLI command, verb, and flag, generated from the CLI's own command table.
- [Reading a collection](https://docs.homespun.dev/agents/collection-read.md): How an app reads a collection, from the synchronous in-browser mirror and its bounded window to the server-backed query API, its pagination contract, and count.
- [Collection retention](https://docs.homespun.dev/agents/collection-retention.md): How a collection's row retention works, from the author-declared default in the manifest to the owner's per-collection runtime override, and what the sweeper does.
- [Embedding in another site](https://docs.homespun.dev/agents/embedding.md): Frame a public Homespun app inside a third-party page with embedAncestors, the copy-paste snippet, the hosted embed.js convenience, and the abuse guidance an anonymous-write embed needs.
- [Manifest reference](https://docs.homespun.dev/agents/manifest-reference.md): Every key of the x-homespun-manifest document, generated from the validator's own rules.
- [Quickstart](https://docs.homespun.dev/agents/quickstart.md): Register, claim, deploy, and seed data, five minutes end to end.
- [Receive data from other systems](https://docs.homespun.dev/agents/receive-data.md): Declare an inbound catch-hook so Stripe, Zapier, Make, Home Assistant, or any system that can POST JSON writes straight into your app.
- [SDK reference](https://docs.homespun.dev/agents/sdk-reference.md): The full window.homespun browser API, generated from the SDK's own surface.

## Reference
- [HTTP API reference](https://docs.homespun.dev/reference/api.md): Every /v1 endpoint the Homespun relay serves, with its method, path, authentication, and purpose.
- [Error reference](https://docs.homespun.dev/reference/errors.md): Every error code the Homespun API can return, with its HTTP status, message, hint, and remediation.

## Also
- [Agent guide](https://docs.homespun.dev/agent-guide/): The full Homespun agent skill, the same content get_skill serves.
- [MCP guide](https://docs.homespun.dev/mcp/): How an MCP client invokes Homespun: tools, prompt, and resource.

## Notes
- Every page above is also available as rendered HTML at the same path without ".md".
- [llms-full.txt](https://docs.homespun.dev/llms-full.txt) inlines the full content of every page in one file.