Files
qqq-cli/packages/cli
james.maesandClaude Fable 5.1 decd6cd39f core+cli: record, query and process parity: columns, filter labels, variant memory, editors, copy, ad hoc widgets
Closes the record, query and process gaps the parity matrix listed. Each capability lands in
the kernel with tests and a thin command on top:

- possible-value labels in --where are resolved to ids, as the web filter sends them
- table columns keeps the query columns per table in the config the TUI column chooser uses
- the variant chosen for a table is remembered per server (--variant - forgets it)
- ad hoc composite widgets: conditional blocks, INPUT_FIELD blocks asked as step fields,
  BUTTON actionCodes offered as choices
- HTML fields show as text; table update -e edits HTML and code in $EDITOR
- CHIP values carry their color and icon (colored on a terminal; tables measure ANSI-free width)
- table get --copy, table api-call (the API playground), script test, table widget-form
  (a dynamicForm on a record form, saved in its merged JSON field)

Stub-server CLI tests cover what the sample cannot exercise (variants, saved views, audits,
application APIs, script tests, dynamicForm).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-31 19:58:52 -05:00
..

@qrun-io/qqq-cli

qqq, the command-line client for QQQ applications. It talks to a QQQ server only through the UI API (/qqq/v1), the same API the web UI uses, so every app, table, field and process comes from the server's metadata.

echo "@qrun-io:registry=https://npm.pkg.github.com" >> ~/.npmrc
npm install -g @qrun-io/qqq-cli@rc
qqq login --server https://admin.example.com
qqq table query person -w "lastName STARTS_WITH S" -o -id -l 5

Requires Node.js 20 or later, or use a single-file binary from the releases (no Node needed). Servers: UI API 1.6.0 up to 2.0 (qqq --version prints the range).

Grammar, sign-in, profiles, output formats and exit codes: see the repository README and TRY-IT.md.

Apache-2.0