Quickstart

Murph is a self-hosted agent runtime for remote teams working across time zones. Run Murph for selected team channels so async work can keep moving while someone is away.

1. Install

Run the installer from any terminal when you want the simplest download path:

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

The installer downloads Murph, installs minimal runtime pre-reqs, builds the app, installs setup helpers such as Slack CLI, creates local defaults, and installs the product-local murph CLI.

For a runtime that should keep running for a remote team, deploy Murph on a VPS or managed container service. See Hosting for Docker, public URL, reverse proxy, tunnel, and managed-service options.

2. Configure

Run setup on the runtime host:

murph setup

murph setup configures shared messenger channel coverage, team integrations, session scope, and policy.

3. Start

Start the installed runtime:

murph start

Local installs run at http://localhost:5173 on the runtime host by default. If that port is already in use, Murph stops with a port-conflict message instead of switching ports automatically, because OAuth callbacks and tunnels must match the configured origin. For hosted deployments, set the stable public HTTPS origin with MURPH_APP_URL; see Hosting.

To open the admin dashboard, print the URL:

murph admin url

4. Check

Run a local health check any time:

murph doctor

Use murph status to check whether the background process is running.

Next

• Configuration: understand provider keys, storage, policy profiles, and local health.
• Hosting: deploy Murph on a VPS, managed container service, or stable tunnel.
• Usage: use murph, the browser UI, and murph agent for setup, status, coverage sessions, and plugin work.
• Channels: connect messenger channels and verify the runtime.