murmur install-repo

Installs a GitHub Actions workflow that forwards repository events (pushes, PR comments, CI results, reviews) to the murmur webhook. Agents watching branches in this repo receive those events in real time.

Synopsis

murmur install-repo --webhook-url <url>

Arguments

Name	Type	Required	Description
`--webhook-url`	string	yes	Base URL of the murmur webhook service, without the `/ingest` path.

What it does

Finds the git repository root and resolves the repo name from its origin remote.
Mints a repo token via the murmur API, scoped to this repo and tenant.
Writes a GitHub Actions workflow file to .github/workflows/murmur-events.yaml at the repository root, with the webhook URL and repo token baked in. An existing file is overwritten.

After the command completes, commit and push the workflow file to activate event delivery.

Events forwarded

The installed workflow triggers on these GitHub events and forwards them to the webhook:

GitHub event	Trigger
`push`	Push to `main`: delivers changed file lists to agents.
`issue_comment`	Comment on a pull request.
`pull_request_review`	PR review submitted.
`pull_request_review_comment`	Inline review comment.
`check_run`	Third-party app check runs (all activity types).
`workflow_run` (requested, in_progress, completed)	The repo’s own GitHub Actions workflows.
`pull_request` (opened, closed, reopened, labeled)	PR lifecycle changes.
`issues` (opened, labeled)	Issue created or labeled.

Repos owned by a GitHub App tenant receive events through the App webhook directly. murmur install-repo is for repos that use GitHub OAuth tenants or repos outside the App organization.

Examples

Install event delivery for the current repo

murmur install-repo --webhook-url https://webhook.murmur.example.com

  wrote /home/alice/src/backend/.github/workflows/murmur-events.yaml (webhook_url=https://webhook.murmur.example.com, repo=acme/backend)
Done. Commit and push to activate.

Then commit and push:

git add .github/workflows/murmur-events.yaml
git commit -m "Add murmur event delivery"
git push

Errors

Code	Meaning	What to do
usage text printed	`--webhook-url` was not provided. The command prints its usage and writes nothing.	Pass `--webhook-url` with the base URL of your webhook service.
`cannot parse repo from remote URL "<url>"`	The git remote URL is not a recognized GitHub URL.	Verify the `origin` remote points to a GitHub repository.
`org "<org>" uses GitHub App webhook delivery; install-repo is not needed`	The repo belongs to a GitHub App tenant that already receives events via the App webhook.	No action needed: events are delivered automatically.
`resolve git remote`	The repo has no `origin` remote.	Add an `origin` remote that points to GitHub.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login`, or `murmur setup` if the repo is not configured.

Events: how events reach agents
murmur setup: configure your developer profile (prerequisite)
Catalog: repo-config: per-repo configuration in the catalog

Getting Started

Core Concepts

Guides

murmur install-repo

Synopsis

Arguments

What it does

Events forwarded

Examples

Install event delivery for the current repo

Errors

​Synopsis

​Arguments

​What it does

​Events forwarded

​Examples

​Install event delivery for the current repo

​Errors

​Related

Synopsis

Arguments

What it does

Events forwarded

Examples

Install event delivery for the current repo

Errors

Related