CLI: CLI entrypoint
Source: package.json:bin|scripts · Jul 15, 2026
MCP server: No MCP server detected
Source: repo_scan · Jul 15, 2026
Languages: typescript, javascript
Source: github.language+package.json · Jul 15, 2026

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Node.js runtimeNode.js

Source: README excerpt (regex_v1, Jul 15, 2026)

- **Node.js 20+** (developed on Node 24). Uses Node's built-in `node:sqlite`, so installati

Source link

README

Requirements

Using the self-contained installer? You can skip the Node and pnpm requirements below — install.sh / install.ps1 download a pinned, local Node and activate the right pnpm for you. The only thing you'd still want is an LLM server to actually play.

Node.js 20+ (developed on Node 24). Uses Node's built-in node:sqlite, so installation never compiles a native C addon.
pnpm — the repo pins pnpm@11.7.0 via packageManager, so running corepack enable once will fetch the right version automatically (or npm i -g pnpm).
(Optional, but basically needed to actually play) an OpenAI-API-compatible LLM server, either local or a cloud API.

Quick start

The fastest way in is the self-contained installer. It needs no prerequisites — not even Node or pnpm. It downloads a pinned, official Node.js into a local ./.runtime/node folder (verified against nodejs.org's SHA-256 checksums, nothing installed system-wide), activates the exact pnpm pinned in package.json via corepack, installs dependencies, and seeds the sample database. Then a matching run script starts the app.

macOS / Linux

./install.sh      # one-time setup (downloads Node locally, installs, seeds)
./run.sh          # start the server + web client

Windows

powershell -ExecutionPolicy Bypass -File .\install.ps1   # one-time setup
.\run.bat                                                # start the app

Unattended/CI? Pass -y/--yes to install.sh (or -Yes to install.ps1), or set HEARTMORROW_YES=1, to skip the Node-download confirmation prompt.

📱 Works on Termux, too. The Linux installer runs as-is under Termux on Android — ./install.sh then ./run.sh — so you can host Heartmorrow right on your phone and play it from the device's browser. (Point it at a local or remote LLM the same way you would anywhere else.)

Both installers are idempotent — re-run them anytime; they skip the Node download if the vendored copy is already present.

Then open http://localhost:5173.

Manual install

Already have Node.js 20+ and pnpm? Skip the installer and run the steps yourself:

For agents

This page has a .md twin and JSON over the API.

/tools/hmdsimdev-heartmorrow.md GET /api/graphcanon/tools/hmdsimdev-heartmorrow GET /api/graphcanon/graph?tool=hmdsimdev-heartmorrow

heartmorrow

Verify the decision

Maintenance and security

Install

Similar tools

Evidence and technical details

Overview

Capability facts

Categories