# swarmops remote list

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

List the store's git remotes.

```yaml
title: "swarmops remote list"
description: "List the store's git remotes."
group: "remotes"
since: "0.2.0"
mutates: false
identity_required: false
mcp_tool: "remote_list"
envelope_op: "remote_list"
exit_codes: [0]
errors: []
syntax: "swarmops remote list [OPTIONS]"
```

## Syntax

```text
swarmops remote list [OPTIONS]
```

## Required arguments

None.

## Optional arguments

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

## Examples

### CLI

No recorded example yet.

### MCP

No recorded example yet.

## Return information

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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `remotes` | `array of RemoteInfo` | yes | The remotes; empty when the store has none. |

Envelope `op`: `remote_list`.

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 remove`](remote-remove.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)