# swarmops upgrade

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

Move the store to the latest format this build writes. Irreversible: older releases do not open it afterwards.

```yaml
title: "swarmops upgrade"
description: "Move the store to the latest format this build writes. Irreversible: older releases do not open it afterwards."
group: "store"
since: "0.4.0"
mutates: true
identity_required: false
mcp_tool: "upgrade"
envelope_op: "upgrade"
exit_codes: [0]
errors: []
syntax: "swarmops upgrade [OPTIONS]"
```

## Syntax

```text
swarmops upgrade [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 `UpgradeResp` (`swarmops schema UpgradeResp` prints its JSON Schema).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `from` | `integer` | yes | The format the store had. |
| `to` | `integer` | yes | The format it has now. |
| `upgraded` | `boolean` | yes | Whether it changed: `false` for a store of the latest format already. |

Envelope `op`: `upgrade`.

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 init`](init.md)
- [`swarmops info`](info.md)
- [`swarmops whoami`](whoami.md)
- [`swarmops schema`](schema.md)
- [`swarmops derive`](derive.md)
- [CLI reference](../cli.md)
- [Error codes](../errors.md)