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

# bd kv

> Key-value store commands

Generated from `bd help --doc kv`.

Commands for working with the beads key-value store.

The key-value store is useful for storing flags, environment variables,
or other user-defined data that persists across sessions.

Examples:
bd kv set mykey myvalue    # Set a value
bd kv get mykey            # Get a value
bd kv clear mykey          # Delete a key
bd kv list                 # List all key-value pairs

```
bd kv [command]
```

## bd kv clear

Delete a key from the beads key-value store.

Examples:
bd kv clear feature\_flag
bd kv clear api\_endpoint

```
bd kv clear <key> [flags]
```

## bd kv get

Get a value from the beads key-value store.

Examples:
bd kv get feature\_flag
bd kv get api\_endpoint

```
bd kv get <key> [flags]
```

## bd kv list

List all key-value pairs in the beads key-value store.

Examples:
bd kv list
bd kv list --json

```
bd kv list [flags]
```

## bd kv set

Set a key-value pair in the beads key-value store.

This is useful for storing flags, environment variables, or other
user-defined data that persists across sessions.

Examples:
bd kv set feature\_flag true
bd kv set api\_endpoint [https://api.example.com](https://api.example.com)
bd kv set max\_retries 3

```
bd kv set <key> <value> [flags]
```