--- id: kv title: bd kv slug: /cli-reference/kv sidebar_position: 999 --- 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 [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 [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 [flags] ```