The current release is v1.2.0, a developer preview. Free and open source under MIT. The editor, runtime, CLI, MCP server, and web and desktop export are all in the box.
macOS 11 or later · arm64 & Intel
Preview builds are not notarized yet. If macOS blocks the first launch, click Done, then System Settings → Privacy & Security → "Open Anyway" (or right-click Hearth.app → Open on macOS 14 and earlier). If macOS says the app "is damaged", run xattr -cr /Applications/Hearth.app, then open it normally.
Windows 10 or later, x64
Fresh out of CI. SmartScreen may ask you to confirm the unsigned installer.
x86_64
Fresh out of CI. Mark the AppImage executable first: chmod +x Hearth-linux-x86_64.AppImage
Older versions and checksums live on the
GitHub releases page.
Prefer building from source? git clone and
npm run app, see the
desktop app guide.
The desktop app wires this up for you: open a project and click a tile in the editor's Agent panel to launch Claude Code, Codex, OpenCode, or Hermes in a real terminal, MCP connected automatically. The CLI and the MCP server also ship as standalone files below, for any other MCP client you want to wire up by hand. Requires Node ≥ 20.
hearth export web needs
hearth-player.js in the same folder as the CLI or
MCP file; hearth export desktop packages the same
build into a native mac/Windows/Linux app. The desktop app has the player built
in. Exported games boot straight into your first scene, with no engine branding. See
the export guide.
node hearth-cli.mjs init "My Game" claude mcp add hearth -- node ~/hearth/hearth-mcp.mjs --project <your game>
Works with Claude Code, Codex, OpenCode, Hermes, or any MCP client. Add
--mode read-only for a no-mutation session; see the
MCP guide for all permission modes.