​
CLI overview

The kvcdn CLI is a single Rust binary for x86-64 Linux that runs on your machine to verify, quantize, benchmark, plot, and upload .kv artifact files. 
kvcdn [OPTIONS] <COMMAND>

​
System requirements

  • x86-64 Linux. ARM64 binaries are not yet published.

​
Global options

OptionEnvironment variableDefaultDescription
--api-urlKVCDN_API_URLhttps://api.kvcachestore.comBase URL of the hosted portal API
--api-keyKVCDN_API_KEY—Bearer token for API-key authentication
--help——Print help for the current command
--version——Print the CLI version

​
Subcommands

CommandPurpose
loginOpen a browser to sign in to the hosted dashboard
logoutClear locally stored credentials
api-keyset, verify, or clear your API key
verifyGenerate or verify a local .kv artifact against a context file
quantQuantize a .kv artifact
benchmarkBenchmark throughput or memory of a .kv artifact
plotGenerate visualizations from benchmark output
uploadUpload a local .kv artifact to the hosted service

​
Authentication

kvcdn authenticates to the hosted API with an API key. Set the key with the KVCDN_API_KEY environment variable or the api-key set command: 
kvcdn api-key set kv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
kvcdn api-key verify
Create and revoke API keys from the dashboard at Settings > API Keys.

​
Typical workflow

# 1. Sign in via the browser
kvcdn login

# 2. Set your API key
kvcdn api-key set kv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 3. Verify a local artifact
kvcdn verify --kv-path ./context.kv --context-file ./context.txt \
  --question "Summarize the key claim."

# 4. Upload it
kvcdn upload ./context.kv --name "Qwen system prompt" --visibility private

# 5. View artifacts in the dashboard
Open [https://kvcachestore.com/app](https://kvcachestore.com/app) to see artifacts in your active project.

​
Next steps