Homie

Homie is a set of open-source tools that let an AI build and run a studio: a website
with games, apps, music and video, deployed to the owner's own Cloudflare account. You ask
your AI for what you want in plain words; it uses Homie to make it, check it in real
browsers and put it online.

It starts with games. The longer-term direction is commerce between AIs, where a
customer's AI and a business's AI (or two businesses' AIs) can find each other's studios
and do business through the same tools.

Install

Homie works as a plugin for AI coding apps, or as an MCP server for any MCP client. Your AI
can run these commands for you.

Claude Code

/plugin install homie --marketplace homie-rocks/homie

From a terminal: claude plugin marketplace add homie-rocks/homie, then
claude plugin install homie@homie.

Codex

codex plugin marketplace add homie-rocks/homie
codex plugin add homie@homie

Start a new session afterwards, and open /hooks to trust Homie's hooks (Codex skips a
plugin's hooks until you do).

Grok

grok plugin install homie-rocks/homie#plugins/homie

Trust the plugin when asked, then start a new session.

Any MCP client (Claude app, Grok chat and others): add a custom connector with the
address https://homie.rocks/mcp.

Claude desktop app: the Homie Desktop Extension (desktop/) runs the toolkit locally.
Download it from https://homie.rocks/make/studio/desktop/.

Command line: npx -y @homie-rocks/studio --help lists the homie-studio commands.
homie-studio mcp runs the same toolkit as a local MCP server over stdio.

Then ask for something, for example "Make a game for my pub and put it online."
Cloudflare asks for your approval before anything goes live.

Core concepts

• Studio: a folder with a studio.json, and the site it deploys to your Cloudflare
  account (a Worker, a D1 database and Durable Objects for live rooms). You own it and pay
  Cloudflare directly, if at all; the free plan is enough to start.
• Parts: reusable pieces that studios share or sell, such as a creature, a level
  generator, a chase camera or an audio pack. Each part has its own licence and
  attribution. Browse them at https://homie.rocks/parts/.
• Tools: the plugin's skills and MCP tools, plus the homie-studio CLI. Your AI uses
  them to set up a studio, build, check, preview, deploy and list its work. The engine
  packages (@homie-rocks/* on npm) are what the games are built on.

The core stays small and general. Anything specific to one kind of business belongs in a
part, not in the toolkit.

Docs

• Getting started: https://homie.rocks/make/studio/ and https://homie.rocks/install.md
• Help: https://homie.rocks/help/
• Release notes: https://homie.rocks/make/studio/changelog/ and CHANGELOG.md
• Parts catalog: https://homie.rocks/parts/
• Studio directory: https://homie.rocks/studios/
• In this repository: plugin, studio toolkit,
  netplay contract, parts rules,
  and each engine package's own README under packages/.

Repository layout

Develop

Node.js 22 or later. Some media tests need ffmpeg, and the browser checks need Chrome.

npm ci
npm run build          # tsc --build
npm test               # build, then every package's tests
npm run test:plugin    # the plugin's skills, against stand-ins (no accounts, no money)
npm run release:check  # what a release would publish

Releases go to npm from the release-* tag through GitHub Actions
(publish.yml), with trusted publishing and provenance.

Contributing

Issues and pull requests are welcome here on GitHub. This repository is a mirror: the
source of truth is a Cloudflare Artifacts repository, and a maintainer lands accepted
changes there, keeping you as the author. Sign off your commits (git commit -s);
CONTRIBUTING.md has the details. Report security problems privately as
SECURITY.md describes.

Licence

Apache-2.0. See LICENSE and NOTICE. The names "Homie" and
"homie.rocks" are not covered by the licence. Copyright 2026 1243116 B.C. Ltd.