> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# aether git

> View diffs, revert files, and manage workspace snapshots

View diffs, revert files, and manage snapshots for the repository in your workspace. All commands run over the workspace WebSocket connection.

## Usage

```bash theme={"dark"}
aether git <subcommand> [flags]
```

Every subcommand accepts the persistent `--workspace` flag. When omitted, the command uses the project's single running workspace.

| Flag | Description |
| - | - |
| `--workspace` | Workspace ID (defaults to the project's running workspace) |

## Subcommands

| Subcommand | Description |
| - | - |
| `diff` | Show changes against the base branch |
| `revert <path>` | Revert a single file to its base branch state |
| `revert-all` | Revert all changes to the base branch state |
| `snapshots` | List git snapshots |
| `restore <messageId>` | Restore the workspace to a snapshot |

## aether git diff

Show a per-file summary of changes against the base branch. Each line shows a status letter, the file path, and the lines added and deleted — not a unified patch.

```bash theme={"dark"}
aether git diff
```

```
Diff against main (2 files changed, +12 -3):

  M  src/auth/login.ts                       +9   -1
  A  src/auth/errors.ts                       +3   -0
```

The status letter is `A` (added), `M` (modified), `D` (deleted), or `R` (renamed).

## aether git revert

Revert a single changed file to its state on the base branch.

```bash theme={"dark"}
aether git revert src/auth/login.ts
```

```
Reverted src/auth/login.ts.
```

## aether git revert-all

Revert all changed files to the base branch state.

```bash theme={"dark"}
aether git revert-all [flags]
```

| Flag | Description |
| - | - |
| `--force` | Skip the confirmation prompt |

<Warning>
  This discards all of the agent's uncommitted modifications in the workspace.
</Warning>

## aether git snapshots

List the git snapshots the agent created during its run.

```bash theme={"dark"}
aether git snapshots [flags]
```

| Flag | Description |
| - | - |
| `--limit` | Maximum number of snapshots to show. Defaults to `20`. |

```bash theme={"dark"}
aether git snapshots --limit 5
```

```
MESSAGE ID      HASH        TIMESTAMP
msg_a1b2c3d4    9f3c1a2     10m ago
msg_e5f6a7b8    1b7e4d8     18m ago
```

## aether git restore

Restore the workspace to a snapshot, identified by its message ID.

```bash theme={"dark"}
aether git restore <messageId> [flags]
```

| Flag | Description |
| - | - |
| `--force` | Skip the confirmation prompt |

```bash theme={"dark"}
aether git restore msg_a1b2c3d4
```

<Warning>
  Restoring discards all changes made after the chosen snapshot.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.