Installation

Murph is installed as a local app plus a murph CLI.

Requirements

• Node.js 20 or newer. Node 20 is the CI target and recommended baseline.
• npm
• A terminal with curl, tar, and mktemp
• An OpenAI or Anthropic API key

Install from the internet

curl -fsSL https://murph-agent.com/install.sh | bash

By default, Murph installs into ~/.murph/app and places the CLI at ~/.local/bin/murph.

If you want to inspect the installer first:

curl -fsSL https://murph-agent.com/install.sh -o install.sh
bash -n install.sh
bash install.sh

Install from a checkout

If you already have the repository:

./install.sh

Start and stop

murph start
murph status
murph stop
murph restart

Use murph start --background when you want Murph to keep running after the terminal closes.

Update

murph update

The updater preserves local state such as .env and data/.

Check your install

murph doctor

If something fails, start with Troubleshooting.