> ## 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 tag rm

> Detach one or more dashboard tags from an existing agent, keeping the rest of its tags.

Detaches [tags](/catalog/tag) from an existing [agent](/concepts/agents). Every other tag the agent carries stays, in its current order. Detaching a tag the agent does not carry changes nothing. The tag itself stays defined in the tenant tag registry. `remove` is an alias for `rm`.

## Synopsis

```bash theme={null}
murmur tag rm [flags] <SLUG> <TAG>...
```

## Arguments

| Name | Type | Required | Description |
| - | - | - | - |
| `SLUG` | string | yes | The agent's slug, a child path, or an absolute path. |
| `TAG` | string | yes | One or more tag names to detach. |

## Flags

| Name | Type | Default | Description |
| - | - | - | - |
| `--workspace` | string | from `murmur.yaml` | Workspace the agent belongs to. |
| `--manager` | string | none | Declare the system responsible for this agent record, recorded as its `managed_by` marker (for example, your automation's name). Later writes that do not declare it are refused unless forced. Leave unset for a manual edit. |
| `--force-ownership` | bool | `false` | Write even when another system manages the agent record. Overrides the `managed_by` marker and nothing else. Without `--manager`, the write releases the record (clears `managed_by`). With `--manager`, that manager becomes the new one. |

Requires `agent.edit` on the agent.

## Output

One line with the agent's tag set after the edit, or `(none)` when no tags remain:

```
<SLUG> tags: <tag>, <tag>
```

When none of the named tags were on the agent, the line ends with `(unchanged)`.

## Examples

### Detach a tag

```bash theme={null}
murmur tag rm fix-auth ready-for-review
```

```
fix-auth tags: backend
```

### Detach the last tag

```bash theme={null}
murmur tag rm fix-auth backend
```

```
fix-auth tags: (none)
```

## Errors

| Code | Meaning | What to do |
| - | - | - |
| none | `agent "<SLUG>" is managed by "<manager>", which may overwrite this change on its next run; re-run with --force-ownership to write anyway and release the resource, clearing its managed_by marker` | Change the tags through the manager, or re-run with `--force-ownership`. |
| `NOT_FOUND` | No agent with that slug exists. | Check the slug with [`murmur ls`](/cli/ls). |
| `PERMISSION_DENIED` | You lack `agent.edit` on the agent. | Ask for a role that grants `agent.edit`. See [authorization](/security/authorization). |

## Related

* [`murmur tag ls`](/cli/tag-ls): list an agent's tags
* [`murmur tag add`](/cli/tag-add): attach tags to an agent
* [`tag`](/catalog/tag): the tenant tag registry