English Français العربية

Homespun

السجل الرسمي البيانات وقواعدها

Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http homespun 'https://homespun.dev/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "homespun": {
            "type": "http",
            "url": "https://homespun.dev/mcp"
        }
    }
}
NPM package @homespunapps/mcp
Claude Code 
claude mcp add homespun -e 'HOMESPUN_API_KEY=<your homespun_api_key>' -e 'HOMESPUN_URL=<HOMESPUN_URL>' -e 'HOMESPUN_AGENT_NAME=<HOMESPUN_AGENT_NAME>' -e 'HOMESPUN_REGISTER_SECRET=<your homespun_register_secret>' -- npx -y @homespunapps/mcp@1.6.98
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "homespun": {
            "command": "npx",
            "args": [
                "-y",
                "@homespunapps/mcp@1.6.98"
            ],
            "env": {
                "HOMESPUN_API_KEY": "<your homespun_api_key>",
                "HOMESPUN_URL": "<HOMESPUN_URL>",
                "HOMESPUN_AGENT_NAME": "<HOMESPUN_AGENT_NAME>",
                "HOMESPUN_REGISTER_SECRET": "<your homespun_register_secret>"
            }
        }
    }
}

متغيرات البيئة

  • HOMESPUN_API_KEY سري Homespun agent API key. If unset, the server auto-registers a fresh agent against the relay on first use and saves the key to the shared CLI store (~/.config/homespun/config.json).
  • HOMESPUN_URL Homespun relay base URL. Defaults to the hosted relay https://homespun.dev; set this to point at a different relay.
  • HOMESPUN_AGENT_NAME Display name for the auto-registered agent on the relay.
  • HOMESPUN_REGISTER_SECRET سري Registration secret, required only for relays running REGISTRATION_MODE=secret.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Homespun
  2. What is in this repository
  3. Getting started
  4. Reference
  5. Contributing
  6. License

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:

PackageWhat it is
@homespunapps/cliThe homespun command line client
@homespunapps/mcpThe MCP server, so an agent can drive Homespun as a tool
@homespunapps/coreShared 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

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.

Contributing

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

License

MIT. See LICENSE.

الأسئلة الشائعة

ما هو Homespun؟

Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.

كيف أثبّت Homespun؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http homespun 'https://homespun.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Homespun إلى مفتاح API؟

نعم. يتطلب HOMESPUN_API_KEY, HOMESPUN_REGISTER_SECRET، وتضبطها في إعداداته.

هل Homespun مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Homespun؟

ينشره homespunapps. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.