Document ion-cli, command line for the ION Factory OS API
Rev 0.1.0 A
License MIT
Source GitHub ↗

ion-cli

The scripts in ion-examples each solve one problem: bulk-create issues from a CSV, audit inventory at a location, run a query. This is those operations as one typed, zero-dependency TypeScript CLI. Auth handled once, dry-run before anything writes, table or CSV out.

Mock mode · runs with no credentials

Zero dependencies

Node 20+ fetch, hand-rolled CSV and table helpers. npm ls --prod prints nothing. Nothing to audit, nothing to break.

Mirrors ion-examples

Auth follows utilities/api.py: Keycloak client credentials, audience = API URL. Query shapes are verbatim from queries.py, so results match the Python scripts.

Safe by default

--dry-run previews every CSV import before it writes. --mock runs the whole tool against fixtures, which is exactly what this page is showing you.

Try it: 30 seconds, no credentials

git clone https://github.com/bnavveer/ion-cli && cd ion-cli
npm install && npm run demo -- inventory --location 301