beads/website/docs/cli-reference/kv.md
matt wilkie dfa8ea4813
fix(docgen): generate CLI docs in one process (#4474)
Add a bulk help docs writer that emits the root CLI reference and website command pages from a single Cobra walk. Update the shell generator to call that mode, preserve the pure-Go docs binary guard, and refresh historical versioned CLI docs only when release snapshotting requests a specific version.

Agent-Signature: codex-gpt-5.5-medium on behalf of matt wilkie
2026-06-22 18:25:58 -07:00

78 lines
1.3 KiB
Markdown

---
id: kv
title: bd kv
slug: /cli-reference/kv
sidebar_position: 999
---
<!-- AUTO-GENERATED: do not edit manually -->
Generated from `bd help --doc kv`
## bd 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 [flags]
```
### 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
bd kv set max_retries 3
```
bd kv set <key> <value> [flags]
```