Install and first launch
Install
macOS
- Open
Howse-<version>-mac-arm64.dmg(Apple silicon) orHowse-<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. - Drag
Howse.apponto theApplicationsfolder in the same window.
Windows 10 or 11 (64-bit)
- Run
Howse-<version>-win-x64-setup.exe. - 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
- Howse doesn't open a browser. Work stays inside the desktop app; you can open several work windows.
- You don't need to install Node.js; it's bundled with the app.
- On first launch, you'll find a sample project (
demo-project), ageneralchannel, a welcome thread, and two agents: a Builder on Codex and a Reviewer on Claude Code. - If an agent's CLI is missing or broken, the app and its settings still open and show which agents can run.
- Without Git, the app and its context store are still set up; the sample project is a plain folder instead of a repository.
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.