Set up with AI
Let Claude Code do the typing. You need a paid Claude plan and the Mac. It follows the project's own instructions for agents: it looks first, asks you plain questions, shows you the wall with pretend devices, and changes nothing until you say yes.
Four steps
Other coding agents can follow the same instructions, AGENTS.md, in the repo.
Install Claude Code
Open Terminal (press Command and Space, type Terminal, press Return) and paste this. Then type
claude, press Return and sign in with your Claude plan. More on claude.com/claude-code.curl -fsSL https://claude.ai/install.sh | bash
Paste this
Copy it and paste it into Claude Code, then press Return.
Set up home hub for my house: https://github.com/Seagey/home-hub Clone it into my home folder and follow its AGENTS.md exactly. Look first without changing anything, ask me the questions one or two at a time in plain words, show me the wall screen with pretend devices, read the plan back and wait for my yes before you change anything. Then help me put the app on my Android tablet.
Answer its questions
It asks one or two at a time, for example:
- Which do you have: AirTouch 5 aircon, Google Cast speakers, TVs with couch-tv?
- What are the rooms, speakers and TVs called, as you say them?
- Who gets their own card? First names only.
- Is it all right to turn speech into text on this Mac? May questions go to Claude?
It never asks for a password. You link Spotify yourself, in a browser. Claude Code asks before it runs each command: read what it shows you, and say yes when it matches what it said it would do.
Say yes, then do the tablet
It reads the plan back and waits. After your yes it sets the hub up and checks it. Then download the app on the tablet and type the address and code it gives you.
What it will and won't do
Before your yes, it only looks: versions, whether the port is free, and a pretend copy of the hub so you can see the wall. It installs nothing outside the home-hub folder and changes nothing in your house.
After your yes it adds one thing that starts at login (com.home-hub.hub), keeps your settings in ~/.home-hub where only your account can read them, and shows you how to undo it.
It never prints your keys, calendar addresses or Spotify details, and never uses a paid API. The instructions it follows are public: AGENTS.md.
Shout Josh a coffee
Home hub is free and open source. Josh builds it in his own house after work. If it runs yours, a coffee keeps the next thing coming.