ekairos-cli

library1.22.3jsnpmunverified

CLI tool for scaffolding and managing Ekairos components in projects. Current stable version is 1.22.3, released monthly. Focused on integration with Ink-based React CLIs and shadcn-style component management. Differentiates from generic CLIs by tightly coupling with the Ekairos design system and offering opinionated defaults for rapid UI development.

web-framework devops

npm install ekairos-cli

github ↗package ↗

INSTALL

IMPORT

SIG · EKAIROS-CLI

ekairos-cli

web-frameworkjavascriptv1.22.3

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ekairos

✓ npx ekairos-cli add button

✗ npm run ekairos

CLI is intended to be run via npx; direct npm script usage may not resolve correctly.

programmatic API

✓ import { cli } from 'ekairos-cli'

✗ const ekairos = require('ekairos-cli')

Package is ESM-only since v1.0; CJS require will fail. Use dynamic import if needed.

types

✓ import type { ComponentConfig } from 'ekairos-cli'

✗ import { ComponentConfig } from 'ekairos-cli'

Type-only imports prevent bundling issues; ComponentConfig is a type, not runtime value.

Initialize a new project with Ekairos CLI, then add components 'button' and 'card' using the add subcommand.

npx ekairos-cli@latest init my-project cd my-project npx ekairos-cli add button npx ekairos-cli add card

ekairos-cli --version

Debug

Known issues

breakingVersion 1.0 moved from CJS to ESM-only. Node <14 not supported.

fix

Update Node to >=14 or use dynamic import if CJS is required.

affects: >=1.0.0

gotchaCLI uses Ink for rendering; must be run in an interactive terminal environment.

fix

Ensure environment supports TTY; avoid piping output without --no-color.

affects: >=1.0.0

deprecatedThe 'generate' command is deprecated in favor of 'add' since v1.20.

fix

Use 'add' subcommand instead of 'generate'.

affects: >=1.20.0

Errors

Common errors & fixes

Error: Cannot find module 'ink'

Missing peer dependency ink.

fix

Install ink: npm install ink

Error [ERR_REQUIRE_ESM]: require() of ES Module ... from ... not supported.

Using CJS require() for ESM-only package.

fix

Use import() or dynamic import; update to ESM.

Command 'generate' not found. Did you mean 'add'?

Deprecated command removed in recent version.

fix

Use 'add' subcommand instead.

Upgrade

Version history

1.22.3latest on npm

Audit

Dependencies

inkoptionalRequired for rendering CLI output in React

reactoptionalPeer dependency for Ink-based CLI rendering

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/e-kairos/ekairos ↗

packagehttps://www.npmjs.com/package/ekairos-cli ↗