keyval

A small command-line helper for storing and retrieving key–value pairs through the keyval.org API.

Requirements

• Node.js (recommended: current LTS or newer)

Running the CLI

You can run keyval CLI in two ways.

1. Recommended: npx (no install)

This is the recommended approach: use npx so you do not install a global module. npm fetches and runs the CLI when you need it.

Set a value

npx keyval set <key> <value>

Get a value

npx keyval get <key>

Example (suggest using a key at least 10 characters long):

npx keyval set my-10-plus-char-key "hello world"
npx keyval get my-10-plus-char-key

2. Global install (Other Option)

Install the package once, then run keyval directly (no npx):

npm i -g keyval

keyval set <key> <value>
keyval get <key>

The CLI prints a success summary for set, and prints the stored value line for get. If something goes wrong, you’ll see an error message on stderr and a non-zero exit code.

If npx keyval does not work

Caching, an unpublished local version, or an older npm can sometimes give you stale or unexpected behavior. Pin the registry package explicitly:

npx keyval@latest set <key> <value>
npx keyval@latest get <key>

Learn more

• Website and service: keyval.org

Module usage

This package exposes default { set, get } from index.js, so you can also import kv from 'keyval' in your own Node projects when you depend on keyval as an npm dependency.

npm install keyval

----

import kv from "keyval";

const s = await kv.set("hello-from-keyval-org", "hello-there");
const v = await kv.get("hello-from-keyval-org");
console.log(v);

OR

async function main() {
  const s = await kv.set("hello-from-keyval-org", "hello-there");
  const v = await kv.get("hello-from-keyval-org");
  console.log(v);
}
main();

Please open a ticket for any bugs or updates at https://github.com/prakis/keyval/issues