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.
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
- Download HomeADE, open the file, and drag HomeADE to Applications.
- 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/homeade2. 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.
- Open Terminal and paste:
curl -fsSL https://claude.ai/install.sh | bash- Type
claudeand press Return. Sign in when it asks, then close Terminal.
3. Choose the notes folder
- Click the antenna icon in the menu bar, then Set up this Mac…
- Under Your notes, click Choose the folder… and pick your vault. HomeADE makes Projects, Areas, and Inbox folders in it if they are missing.
- Under Claude Code, check that it says Found. If it says Not installed, finish step 2 and click Check again.
- 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.