# swarmops remote remove

> Release: 0.11.0 · Last changed: 2026-10-22 · Source: https://github.com/KeiaiLab/SwarmOps/blob/stable/docs/reference/commands/remote-remove.md

Forget a git remote, and the mirror's refs of it; no changeset is removed.

```yaml
title: "swarmops remote remove"
description: "Forget a git remote, and the mirror's refs of it; no changeset is removed."
group: "remotes"
since: "0.2.0"
mutates: true
identity_required: false
mcp_tool: ""
envelope_op: "remote_remove"
exit_codes: [0]
errors: []
syntax: "swarmops remote remove [OPTIONS] <NAME>"
```

## Syntax

```text
swarmops remote remove [OPTIONS] <NAME>
```

## Required arguments

### `NAME`

Syntax: `<NAME>`.

The remote's name.

## Optional arguments

The command also takes the [global options](../cli.md#global-options).

## Examples

### CLI

No recorded example yet.

## Return information

`result` is a `RemoteRemoveResp` (`swarmops schema RemoteRemoveResp` prints its JSON Schema).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | yes | The remote's name. |
| `removed_refs` | `integer` | yes | How many of the mirror's refs of the remote were removed. |

Envelope `op`: `remote_remove`.

Exit codes:

- `0`: Success.

## Errors

No golden step shows this command failing yet.

Any command that opens a store may also fail with a store error, such as [`E_NOT_A_REPO`](../errors.md#e_not_a_repo), [`E_IO`](../errors.md#e_io) or [`E_STORE_CORRUPT`](../errors.md#e_store_corrupt); a command line the grammar refuses is [`E_INVALID_ARG`](../errors.md#e_invalid_arg) (exit 2).

## See also

- [`swarmops clone`](clone.md)
- [`swarmops remote add`](remote-add.md)
- [`swarmops remote list`](remote-list.md)
- [`swarmops fetch`](fetch.md)
- [`swarmops push`](push.md)
- [`swarmops sync`](sync.md)
- [`swarmops sync status`](sync-status.md)
- [CLI reference](../cli.md)
- [Error codes](../errors.md)