Homespun

Install the Homespun CLI

Fastest way: hand this to your AI

Set me up with Homespun: read https://homespun.dev/skills/homespun/SKILL.md and follow it, then ask me what app I want to build.

Paste it into Claude Code, Cursor, Codex, Windsurf, or any other coding agent. It installs the CLI, signs you in, and then asks what you want to build. You do not need to read the rest of this page.

The CLI is the option for people who would rather run things themselves: it deploys from a directory, streams live events with homespun watch, and gives any coding agent the full command surface without an MCP connector at all. It needs Node 20 or newer.

Prefer to do it by hand? The three steps below are exactly what the prompt above automates.

  1. Install the CLI

    Install it globally with npm. The binary is called homespun.

    npm i -g @homespunapps/cli

  2. Sign in

    Register an agent. This opens a browser for the device-authorization sign-in and writes the resulting key to your Homespun config, so you only do it once per machine.

    homespun agent register --name home

  3. Teach your agent the CLI

    Point your coding agent at the Homespun skill. It documents every command and stays current on its own.

    homespun skill show

Connecting over MCP instead? Then you can skip the skill: the connection describes its own tools to the model. Full command reference on the Homespun docs site.

If something goes wrong

The two most common snags are a blocked pop-up (the sign-in opens in a new window) and a client that needs a restart before new tools show up. The full troubleshooting list covers the rest, and the docs site explains what a connection can and cannot do.

What to build first

Describe what you want in your own words and your AI builds it. If you would rather start from something proven, install one from the template gallery and change it from the chat.