CLI

iot is the platform's command-line tool. Today it handles authentication, environment contexts, preferences, and browsing the API reference.

Install

The CLI ships as an npm package and runs on Node 20+. It exposes three binary names — iot (primary), plus mkd-iot and mki.

npm install -g @manfred-kunze-dev/iot-cli

Authenticate

Sign in by pasting an API key. Your credentials are stored locally, per context.

iot auth login          # paste an API key
iot auth status         # verify the key works
iot auth logout

Contexts and config

A context is a named environment — an API key and base URL — so you can switch between, say, staging and production without re-entering credentials.

iot context list
iot context create staging
iot context use staging
iot context current

User preferences (default output format, color mode, page size) are managed with iot config get|set|unset|list.

Browse the API

The CLI bundles the API reference and lets you explore it offline:

iot docs list
iot docs sections
iot docs search readings
iot docs show <operationId>

Global flags

--api-key, --base-url, --context, --json, --no-color, --verbose work across commands.