1 / 7

Install and first launch

Applies to the current Howse beta

Install

macOS

  1. Open Howse-<version>-mac-arm64.dmg (Apple silicon) or Howse-<version>-mac-x64.dmg (Intel). Not sure which Mac you have? Open the Apple menu and choose About This Mac. "Chip: Apple M…" means Apple silicon.
  2. Drag Howse.app onto the Applications folder in the same window.

Windows 10 or 11 (64-bit)

  1. Run Howse-<version>-win-x64-setup.exe.
  2. Howse installs for your user account only (no administrator rights needed), adds a Start menu shortcut, and opens. To uninstall, go to Settings → Apps.

Signing and notarization

Public macOS installers, starting with 0.6.0, are signed with an Apple Developer ID and notarized by Apple.

The Windows version is a beta and isn't code-signed yet. When you run the installer, SmartScreen may say "Windows protected your PC." Click More info, then Run anyway. If Smart App Control is on (Windows 11) or your organization blocks unsigned apps, Windows may block the installer outright. In that case, you can't install Howse on that PC until a signed build is available.

Only download installers from the official links on the Howse website or GitHub Releases.

What you'll see first

Updates

Windows 0.59 series: These releases use full installers without UI patches. Finish your work, quit Howse, and run the latest installer manually to update. The app does not offer a full update within the same 0.59 series. Keep your app data folder; projects and conversations are stored outside the installed app. macOS users can receive compatible UI patches.

Version 0.46.0 fixes native-core startup recovery, thread stopping, and optional Codex instructions, and keeps open run confirmation dialogs in sync with current locks. The full update can download in the background, or you can download the installer and replace the app manually. The fixes take effect after you restart; existing projects and conversations remain outside the app bundle.

If the original 0.28.0 build fails to open with a code-signing error, download the republished 0.28.0 installer and replace the app. The same version number does not trigger an automatic update. Projects and conversations are stored outside the app; do not delete your data folder.

Howse ships small updates several times a week. The app updates itself; Compatible UI-only changes apply without a restart.

Each build updates only from releases for its own platform. For example, an Intel Mac build never installs an Apple silicon update, and vice versa.

UI-only patches apply without restarting only when their core fingerprint matches the installed app. A PATCH version number alone does not imply that an update can apply without restarting. Full app updates require a new launch; wait until active work finishes before restarting.

On macOS, if you're still on an older unsigned beta, download the current DMG and replace the app manually.

The sidebar update button follows your theme. If restarting is blocked or an update fails, the sidebar shows a warning toast that disappears automatically. You can review update errors again in Settings → Updates.

Public releases support macOS Apple silicon and Intel (signed and notarized), and Windows x64 (unsigned beta). Desktop-to-desktop and mobile remote access use the existing account, approved devices, and compatible server policy. This release adds no cloud workspace features and does not redeploy the server.

After updates, Howse removes UI patches and temporary downloads that are no longer in use. Files needed by the current screen, installation, or recovery are preserved.