How We Design Features for Wrangler, the Cloudflare Workers CLI
Sep 17, 2019Ashley M Lewis, Gabbi Fisher

Summary
This post details the iterative design process for adding Workers KV functionality to the Wrangler CLI. It outlines three attempts at designing the command-line interface, highlighting lessons learned regarding command taxonomies, inspiration from other CLIs, and the importance of avoiding raw ID strings by leveraging the `wrangler.toml` configuration file for mapping human-readable names to KV namespace IDs. The final design uses colon-delimited command namespacing (e.g., `kv:namespace`, `kv:key`, `kv:bulk`) for clarity and explicitness.