Skip to content

dannylee1020/murph

Repository files navigation

Murph

License: Apache-2.0 Docs

Murph is a self-hosted agent runtime for remote teams working across time zones. Start a coverage session before someone logs off; Murph watches selected team channels, uses connected work context, and sends, queues, or skips replies based on policy.

Murph runs as one runtime on a host you control. Tools, integrations, policy, credentials, plugins, config, review, and channel coverage are shared by that runtime host so async work stays visible to the team.

Murph is not a general work assistant or enterprise search layer. It is built for one workflow: keep work moving while someone is away, then show what happened afterward.

Getting started

The simplest download path is curl:

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

For a hosted Murph runtime, use Docker with a stable public URL:

MURPH_APP_URL=https://agent.example.com \
docker compose -f deploy/docker-compose.yml exec murph murph setup

See Hosting for VPS, managed-service, tunnel, and Docker deployment details.

Documentation

Topic What's covered
Quickstart Install, set up, start, and check health.
Installation Installer behavior and manual install paths.
Hosting Docker deployment, VPS hosting, managed services, and public URLs.
Configuration Provider keys, storage, policy, and runtime settings.
Usage CLI, browser UI, sessions, review, and daily operation.
Channels Messenger channels for remote-team coverage.
Integrations Shared context sources such as Notion, GitHub, Linear, and custom plugins.
Plugins Extend Murph with Murph Agent, plugins, skills, and read-only tools.
Policy Autonomy and review rules.
Contributing Local development and contribution workflow.

Murph Agent

Murph Agent is the primary interface for local setup and extension work. Use it to add tools, create plugins, connect new context sources, adjust policy, and debug setup from the same host that runs Murph.

murph agent

Learn more in Murph Agent.

What you can connect

Category Options
Channels Built-in messenger channels for remote-team coverage
LLM providers OpenAI, Anthropic
Integrations Notion, GitHub, Linear, and custom plugins
Tools Web search, web fetch, file read, shell, and custom tools
Storage SQLite and local files

Contributing

Read CONTRIBUTING.md before opening a pull request. Keep changes focused, include validation, and update docs for user-facing behavior.

For local development:

npm install
npm run dev
npm test

Open an issue before starting non-trivial core/runtime changes.

License

Apache 2.0