# atuin kv

<!-- Generated by web/apps/docs/scripts/gen-reference.ts from the Atuin source. Do not edit. -->

Get or set small key-value pairs

```sh
atuin kv <COMMAND>
```

## `atuin kv set`

Set a key-value pair

```sh
atuin kv set [OPTIONS] --key <KEY> [VALUE]
```

### Arguments

- `<VALUE>`: Value to store (reads from stdin if not provided)

### Options

- `-k <KEY>`, `--key <KEY>`: Key to set. Required.
- `-n <NAMESPACE>`, `--namespace <NAMESPACE>`: Namespace for the key-value pair. Default: `default`.

## `atuin kv delete`

Delete one or more key-value pairs

```sh
atuin kv delete [OPTIONS] <KEYS>...
```

### Arguments

- `<KEYS>...`: Keys to delete

### Options

- `-n <NAMESPACE>`, `--namespace <NAMESPACE>`: Namespace for the key-value pair. Default: `default`.

## `atuin kv get`

Retrieve a saved value

```sh
atuin kv get [OPTIONS] <KEY>
```

### Arguments

- `<KEY>`: Key to retrieve

### Options

- `-n <NAMESPACE>`, `--namespace <NAMESPACE>`: Namespace for the key-value pair. Default: `default`.

## `atuin kv list`

List all keys in a namespace, or in all namespaces

```sh
atuin kv list [OPTIONS]
```

### Options

- `-n <NAMESPACE>`, `--namespace <NAMESPACE>`: Namespace to list keys from. Default: `default`.
- `-a`, `--all-namespaces`: List all keys in all namespaces

## `atuin kv rebuild`

Rebuild the KV store

```sh
atuin kv rebuild
```