kintura

kintura

The Kintura CLI — install and manage production-ready page templates from kintura.xyz.

npx kintura login
npx kintura add strata --stack=react

Installation

npm install -g kintura
# or use directly:
npx kintura <command>

Requires Node.js ≥ 20.

Commands

kintura login

Opens your browser to authorize the CLI with your Kintura account. Stores a token in the OS keychain (falls back to ~/.config/kintura/token).

kintura login [--debug]

kintura logout

Revokes the local token and invalidates it server-side.

kintura logout [--debug]

kintura whoami

Prints your account details.

kintura whoami [--json] [--debug]

kintura list

Lists all available templates. No auth required.

kintura list [--json]

kintura info <slug>

Shows information about a specific template.

kintura info strata [--stack=react] [--json] [--debug]

kintura add <slug>

Installs a template into the current project.

kintura add strata [--stack=react] [--dry-run] [--json] [--yes] [--force] [--debug]

Flags:

• --stack — Framework variant (react, vanilla, nuxt, astro). Default: react.
• --dry-run — Print the install plan without writing any files.
• --json — Emit machine-readable JSON to stdout (agent-friendly).
• --yes — Skip confirmation prompts.
• --force — Overwrite conflicting files.
• --debug — Enable verbose HTTP logging (Authorization headers are redacted).

Exit Codes

--json Output Shape

The add command emits a single JSON line on --json:

{
  "ok": true,
  "slug": "strata",
  "stack": "react",
  "version": "1.0.0",
  "installed": ["app/strata/Strata.tsx"],
  "skipped": [],
  "conflicts": [],
  "deps_added": { "@kintura/engine-react": "^1.0.0" },
  "next_steps": ["npm install  # install deps"]
}

On error:

{ "ok": false, "error": "Not entitled to template 'strata'", "exit": 2 }

Token Storage

The CLI stores your auth token in the OS keychain via keytar. If keytar is unavailable (native addon build failure), it falls back to a file at ~/.config/kintura/token with 0600 permissions. A warning is printed to stderr when the fallback is used.

Manifest Validation

import { validateManifest } from "kintura/manifest";

const result = validateManifest(data);
if (result.valid) {
  console.log(result.manifest.slug); // "strata"
} else {
  console.error(result.errors);
}

License

MIT — see LICENSE.