> ## 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 suggest-terminate

> Flag an agent for termination, or withdraw the flag; depending on the agent's mode this shows a delete button or terminates it at once.

Raises a termination suggestion on an [agent](/concepts/agents), or withdraws one with `--clear`. The typical caller is an agent flagging itself when its work is done: on a VM, run the command with no slug.

What a suggestion does depends on the agent's suggest-terminate mode:

| Mode | Effect |
| - | - |
| `suggest` (default) | Advisory only. The dashboard shows a delete button next to the agent's slug, with the reason as a tooltip. A person decides whether to kill the agent. |
| `immediate` | The server terminates the agent at once, the same way [`murmur kill`](/cli/kill) does. No delete button is shown. |

The mode resolves in this order: the per-spawn override ([`murmur spawn --suggest-terminate-mode`](/cli/spawn)), then the [workspace's](/catalog/workspace) `suggest_terminate_mode`, then the `suggest` default.

## Synopsis

```bash theme={null}
murmur suggest-terminate [flags] [slug]
```

On a VM, the slug is optional. If you omit it, the command flags 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). |
| `--reason` | string | no | Reason shown in the dashboard. At most 280 bytes. Ignored with `--clear`. |
| `--clear` | bool | no | Withdraw a previously raised suggestion. Default: `false`. |
| `--json` | bool | no | Print the `SuggestTerminateResponse` as JSON instead of the text line. Default: `false`. |
| `--workspace` | string | no | Workspace name. Overrides the value from `murmur.yaml`. |

Raising or clearing a suggestion requires `agent.delete` on the agent, the same permission as [`murmur kill`](/cli/kill), in either mode.

## Output

```
suggested termination of <slug>
cleared termination suggestion for <slug>
```

`<slug>` reads `self` when the slug was omitted on a VM.

## Examples

### Flag yourself from a VM

```bash theme={null}
murmur suggest-terminate --reason "PR merged; nothing left to do"
```

```
suggested termination of self
```

### Flag another agent

```bash theme={null}
murmur suggest-terminate fix-auth --reason "superseded by fix-auth-v2"
```

```
suggested termination of fix-auth
```

### Withdraw a suggestion

```bash theme={null}
murmur suggest-terminate --clear fix-auth
```

```
cleared termination suggestion for fix-auth
```

## Errors

| Code | Meaning | What to do |
| - | - | - |
| `NOT_FOUND` | No agent with that slug exists. | Check the slug with [`murmur ls`](/cli/ls). |
| `PERMISSION_DENIED` | You lack `agent.delete` on the agent. | Ask for a role that grants `agent.delete`. See [authorization](/security/authorization). |
| `INVALID_ARGUMENT` | `reason exceeds 280 byte limit (<N> bytes)` | Shorten the reason. |
| `INVALID_ARGUMENT` | `reason contains control character <U+XXXX>` | Remove control characters. Newlines are allowed. |
| `UNAUTHENTICATED` | Identity token is missing or expired. | Run [`murmur login`](/cli/login). |

## Related

* [`murmur kill`](/cli/kill): cancel an agent directly
* [`murmur delete`](/cli/delete): permanently purge a stopped agent
* [`murmur spawn`](/cli/spawn): set `--suggest-terminate-mode` at spawn time
* [`workspace`](/catalog/workspace): workspace-level suggest-terminate mode