embry.dev

Set up HomeADE

HomeADE is the project desk for the agents on this computer. It runs Claude, Codex, or Grok beside your notes. Setup on a Mac takes about ten minutes. HomeADE does not need another app.

About HomeADE

What you need

  • A Mac with macOS 14 or later. A Windows PC can run the beta, below.
  • A Claude plan or an Anthropic API key. HomeADE runs Claude Code, which you install and sign in to yourself. Codex and Grok are optional.
  • A notes folder. An Obsidian vault works best, but any folder will do.

1. Install HomeADE on your Mac

  1. Download HomeADE, open the file, and drag HomeADE to Applications.
  2. Open HomeADE. Apple has signed and notarized it, so the Mac opens it without a warning. An antenna icon appears in the menu bar. To start HomeADE each time you log in, click the icon and turn on Open at login.

Or install with Homebrew:

brew install --cask jtembry/homeade/homeade

2. Install Claude Code

Chats run in Claude Code on your Mac, on your own Claude plan. Today, mail, and the calendar work before this step. The assistants do not.

  1. Open Terminal and paste:
curl -fsSL https://claude.ai/install.sh | bash
  1. Type claude and press Return. Sign in when it asks, then close Terminal.

3. Choose the notes folder

  1. Click the antenna icon in the menu bar, then Set up this Mac…
  2. Under Your notes, click Choose the folder… and pick your vault. HomeADE makes Projects, Areas, and Inbox folders in it if they are missing.
  3. Under Claude Code, check that it says Found. If it says Not installed, finish step 2 and click Check again.
  4. Click Start. A window opens.

Add Codex or Grok

Install either command-line tool and sign in to it. HomeADE lists what it finds under Settings → Agents on this machine, with the command for any that is missing.

Windows (beta)

The Windows beta runs the same screens in a window and a tray icon. It is not yet code-signed, so Windows warns you: click More info, then Run anyway. Pick a vault under Settings → Vault → Change folder…, and install and sign in to Claude Code, Codex, or Grok yourself.

If something goes wrong

  • The HomeADE window says it has no token. Setup is unfinished. Click the antenna icon, then Set up this Mac…
  • Chats do not start. Check that Claude Code is installed and signed in, then click Restart HomeADE… in the menu.

Still stuck? Email joel@embry.dev.

Send me a message

I read everything and reply within two business days.

Book a free consultation

A 15-minute phone call. I call you. I confirm within two business days.

Tuesday and Thursday, 5:00 to 6:00 PM Eastern.