CLI

Murph installs one product-local CLI for normal use. murph controls the shared messenger channel runtime.

Murph OSS is CLI-first. Use the browser dashboard for Coverage, Review, Activity, and read-only Admin inspection. Use murph setup, murph monitor, murph policy, and murph agent for configuration and advanced control.

Setup commands

murph setup
murph setup provider
murph setup slack
murph setup discord
murph setup channels
murph setup policy
murph setup status

Use murph setup on the runtime host. The wizard creates core local config, chooses the runtime AI provider, chooses a messenger provider, captures OAuth owner identity, saves channel defaults, sets the schedule, selects policy, and prints setup status.

Setup changes refresh active config-bound sessions automatically. If Murph is already handling a request, the refresh is marked pending and applied at the next run boundary.

Use murph setup provider to choose the runtime AI provider first, then the Murph Agent model. murph setup ai remains as a compatibility alias.

Use focused channel commands when only one channel area changed:

murph setup slack
murph setup discord
murph setup channels

murph setup channels saves watched-channel defaults for remote-team coverage.

murph setup identity remains as a compatibility check for OAuth owner identity. If identity is missing, reconnect the messenger provider; Murph does not accept a manual owner ID.

Runtime commands

murph start
murph start --background
murph status
murph logs
murph stop
murph restart
murph open

Use these commands to run Murph locally and inspect the local process.

Monitor commands

murph monitor
murph monitor status
murph monitor start
murph monitor start --until 09:00 --timezone America/Los_Angeles
murph monitor start --duration 4 --mode dry_run --channels C123,C456
murph monitor stop
murph monitor stop --all

Use murph monitor to script coverage sessions from the terminal. Without flags, monitor shows active sessions and monitor start uses saved setup defaults. Use --workspace, --channels, --mode, --until, --timezone, and --duration for one-off overrides. Use --json on any monitor subcommand when another tool needs the raw API response.

Admin commands

murph admin url

Use murph admin url to print the admin dashboard URL for the current runtime host.

The OSS Admin page is inspect-only. It shows setup, policy, and integration state, then points back to CLI and Murph Agent commands for changes.

Health commands

murph doctor

Use murph doctor after setup changes or when a channel, provider, or runtime check fails.

Credential commands

Murph stores runtime-host secrets in ~/.murph/.credentials.

murph credentials doctor
murph credentials list

Use these commands to inspect runtime-host credential readiness without printing secret values.

Policy commands

murph policy profiles
murph policy get
murph policy preview --profile engineering
murph policy preview --profile engineering --session-mode dry_run
murph policy set --profile engineering
murph policy set --profile yolo

Use policy commands to inspect or switch the local autonomy profile. New sessions inherit the selected profile's mode unless you choose a temporary session override. There is no separate durable --mode policy setting. For custom profiles, prefer murph agent; direct file editing lives in ~/.murph/policies/*.md.

Policy changes also refresh active config-bound sessions. Sessions started with an explicit policy override keep that explicit policy.

Maintenance commands

murph update
murph uninstall --dry-run
murph uninstall

Use maintenance commands from the installed product host. Uninstall removes the installed CLI link and Murph home contents only. It preserves the app directory, including the default ~/.murph/app, and leaves unrelated system tools alone.