Wooden Amethyst Logo
Wooden Amethyst

Support

Help with installing RowHouse, storage and sync, AI assistants, automations and updates.

Last updated: 2026-11-03

To report a bug or ask for a feature, open an issue on GitHub. For anything else, email [email protected].

Include your RowHouse version (shown in RowHouse › About RowHouse), your macOS version and what happened. A screenshot helps. Never send an API key or a personal access token.

What do I need?

A Mac with macOS 14 Sonoma or later, with Apple silicon or Intel. To sync between Macs, turn on iCloud Drive on each Mac, signed in with the same Apple Account.

How do I install RowHouse?

Download the DMG from the latest release on GitHub, open it and drag RowHouse into Applications. RowHouse is signed with a Developer ID and notarised by Apple, so it opens like any other app.

Where are my bases stored?

In iCloud Drive › RowHouse. Each base is a folder of plain files that you can back up or inspect. To keep your bases on this Mac only, or in a folder of your own, open Settings › Storage. Switching locations does not move existing bases, so move the .rowhouse folders in Finder if you want to bring them along.

How do my Macs stay in sync?

Each Mac writes its own change log inside the base's folder, and every Mac merges the others' logs. You can edit on two Macs at once, or while offline, and the changes merge when iCloud Drive catches up. When two Macs change different fields of a record, both changes survive. When they change the same field, the latest edit wins.

RowHouse says it cannot reach its folder

Allow RowHouse to use iCloud Drive in System Settings › Privacy & Security › Files & Folders, then click Try Again. You can also choose another place for your bases in Settings › Storage.

How do I connect Claude Code, Codex or Claude Desktop?

For Claude Code, run this in Terminal:

claude mcp add --scope user rowhouse -- \
  /Applications/RowHouse.app/Contents/MacOS/rowhouse-mcp

Setup for Codex and Claude Desktop is in Settings › AI Assistants. Edits from an assistant sync like another Mac's and are labelled with its name.

How do AI fields work?

AI fields and the Generate text with AI automation step use Claude. Add your own Anthropic API key in Settings › Claude AI. RowHouse keeps the key in your Mac's Keychain.

Why does Send email ask to control Mail?

The Send email step sends messages through the Mail app on your Mac. Allow it when macOS asks, or turn on Mail for RowHouse in System Settings › Privacy & Security › Automation. Mail needs an email account set up.

How do I import from Airtable?

Click New Base at the bottom of the sidebar and choose Import from Airtable…. You need a personal access token from airtable.com/create/tokens. RowHouse uses the token for that import only and never saves it.

How do I back up a base?

Right-click the base in the sidebar and choose Export Backup…. To bring a backup back, click New Base at the bottom of the sidebar and choose Restore Backup….

How do I update RowHouse?

Choose RowHouse › Check for Updates…. RowHouse also checks once a day and shows Update available at the bottom of the sidebar when a new version is out. You can turn the daily check off in Settings › General.