{"id":18286,"library":"ekairos-cli","title":"ekairos-cli","description":"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.","status":"active","version":"1.22.3","language":"javascript","source_language":"en","source_url":"https://github.com/e-kairos/ekairos","tags":["javascript","cli","ink","ekairos","shadcn"],"install":[{"cmd":"npm install ekairos-cli","lang":"bash","label":"npm"},{"cmd":"yarn add ekairos-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add ekairos-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required for rendering CLI output in React","package":"ink","optional":true},{"reason":"Peer dependency for Ink-based CLI rendering","package":"react","optional":true}],"imports":[{"note":"CLI is intended to be run via npx; direct npm script usage may not resolve correctly.","wrong":"npm run ekairos","symbol":"ekairos","correct":"npx ekairos-cli add button"},{"note":"Package is ESM-only since v1.0; CJS require will fail. Use dynamic import if needed.","wrong":"const ekairos = require('ekairos-cli')","symbol":"programmatic API","correct":"import { cli } from 'ekairos-cli'"},{"note":"Type-only imports prevent bundling issues; ComponentConfig is a type, not runtime value.","wrong":"import { ComponentConfig } from 'ekairos-cli'","symbol":"types","correct":"import type { ComponentConfig } from 'ekairos-cli'"}],"quickstart":{"code":"npx ekairos-cli@latest init my-project\ncd my-project\nnpx ekairos-cli add button\nnpx ekairos-cli add card","lang":"typescript","description":"Initialize a new project with Ekairos CLI, then add components 'button' and 'card' using the add subcommand."},"warnings":[{"fix":"Update Node to >=14 or use dynamic import if CJS is required.","message":"Version 1.0 moved from CJS to ESM-only. Node <14 not supported.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Ensure environment supports TTY; avoid piping output without --no-color.","message":"CLI uses Ink for rendering; must be run in an interactive terminal environment.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use 'add' subcommand instead of 'generate'.","message":"The 'generate' command is deprecated in favor of 'add' since v1.20.","severity":"deprecated","affected_versions":">=1.20.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Install ink: npm install ink","cause":"Missing peer dependency ink.","error":"Error: Cannot find module 'ink'"},{"fix":"Use import() or dynamic import; update to ESM.","cause":"Using CJS require() for ESM-only package.","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module ... from ... not supported."},{"fix":"Use 'add' subcommand instead.","cause":"Deprecated command removed in recent version.","error":"Command 'generate' not found. Did you mean 'add'?"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}