> ## 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 editor

> Print, or open in a browser, the VS Code URL for an agent's VM workspace.

Prints the browser VS Code URL for an [agent's](/concepts/agents) VM. The URL opens the editor on the agent's workspace directory, `/home/murmur/workspace`. The first open installs and starts the editor on the VM.

The command builds the URL locally from your configuration. It makes no API call.

Opening the URL requires `agent.edit` on the agent: the editor's integrated terminal is a shell on the VM, the same access [`murmur ssh`](/cli/ssh) grants.

## Synopsis

```bash theme={null}
murmur editor [--open] [slug]
```

On a VM, the slug is optional. If you omit it, the command prints the URL for the current agent.

## Arguments

| Name | Type | Required | Description |
| - | - | - | - |
| `slug` | string | on laptop | The agent's slug, a child path, or an absolute path. Optional on VMs (defaults to self). |
| `--open` | bool | no | Also open the URL in the default browser. Default: `false`. |

## Output

One line: the port-proxy URL for the editor port, with the workspace folder as a query parameter.

## Examples

### Print the editor URL

```bash theme={null}
murmur editor fix-auth
```

```
https://github_app-acme-a1b2c3d4e5f6-9022.port.murmur.example.com/?agent=fix-auth&folder=/home/murmur/workspace
```

### Open the editor in a browser

```bash theme={null}
murmur editor --open fix-auth
```

## Errors

| Code | Meaning | What to do |
| - | - | - |
| none | `public_url not configured` | Set `public_url` in your [configuration](/configuration/murmur-yaml). |
| none | `slug is required when not running on a VM` | Pass the agent's slug. |
| none | `username not set — configure it in .murmur/murmur.local.yaml` | Run [`murmur setup`](/cli/setup) or [`murmur login`](/cli/login) to record your username. |

## Related

* [`murmur ssh`](/cli/ssh): open a shell on an agent's VM
* [`murmur url port`](/cli/url-port): print port-proxy URLs from a VM
* [`murmur port-forward`](/cli/port-forward): tunnel to a port from your laptop