> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# murmur url agent

> Print the Murmur dashboard URL for an agent so you can share a link to its timeline, artifacts, and live status view with a teammate.

Prints the dashboard URL for an [agent](/concepts/agents). The URL opens the [agent's](/concepts/agents) task view in the murmur dashboard. No API call is made — the URL is constructed locally from configuration and the resolved slug.

## Synopsis

```bash theme={null}
murmur url agent [slug]
```

On a VM, the slug is optional — omitting it prints the URL for the current [agent](/concepts/agents). A relative slug on a VM resolves as a child of the current [agent](/concepts/agents). On your laptop, a relative slug resolves as a root [agent](/concepts/agents) in the configured [workspace](/concepts/workspaces).

Absolute paths are also accepted — for example `/w/backend/u/alice/fix-auth` — to address any [agent](/concepts/agents) regardless of context.

## Arguments

| Name   | Type   | Required  | Description                                                               |
| ------ | ------ | --------- | ------------------------------------------------------------------------- |
| `slug` | string | on laptop | The [agent's](/concepts/agents) slug. Optional on VMs (defaults to self). |

## Examples

### Dashboard URL for an agent

```bash theme={null}
murmur url agent fix-auth
```

```
https://murmur.example.com/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Ffix-auth
```

### Self URL on a VM

When running on an [agent](/concepts/agents) VM, omit the slug to get the current [agent's](/concepts/agents) dashboard URL:

```bash theme={null}
murmur url agent
```

### Child agent URL on a VM

When running on an [agent](/concepts/agents) VM, a relative slug resolves as a child:

```bash theme={null}
murmur url agent add-tests
```

```
https://murmur.example.com/github_oauth/acme/task/github_oauth%2Facme%2Fw%2Fdefault%2Fgithub_oauth%2Falice%2Fdirector%2Fadd-tests
```

## Errors

| Code                        | Meaning                                                                       | What to do                                                            |
| --------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| `public_url not configured` | The `public_url` field is missing from `murmur.yaml`.                         | Set `public_url` in your [configuration](/configuration/murmur-yaml). |
| `workspace not set`         | No [workspace](/concepts/workspaces) is configured and the slug requires one. | Set `workspace` in `murmur.yaml`.                                     |
| `username not set`          | No username is configured and a relative slug requires one.                   | Set `username` in `murmur.local.yaml`.                                |
| `tenant.provider not set`   | The tenant provider is not configured.                                        | Set `tenant.provider` in `murmur.yaml`.                               |
| `tenant.org not set`        | The tenant org is not configured.                                             | Set `tenant.org` in `murmur.yaml`.                                    |

## Related

* [Agents](/concepts/agents) — concept overview
* [Workspaces](/concepts/workspaces) — concept overview
* [`murmur url port`](/cli/url-port) — print the port-proxy URL for a VM port
* [`murmur status`](/cli/status) — check an [agent's](/concepts/agents) phase and progress
* [`murmur ls`](/cli/ls) — list running [agents](/concepts/agents)