@kepler-io/cli NPM

Kepler CLI

CLI project for Kepler.

CommonJS module, because of oclif, they are not supporting building for ESM.

Run

Quick run

In this case the CLI will use current folder (./tooling-framework/cli), which is not a good idea for creating a new projects via CLI. Instead of kepler command we leverage NPM scripts, so you can replace it with yarn start.

$> yarn start

Build the project yarn build
Run with yarn start
You should see a help page for Kepler CLI, similar to this:

Command examples:

yarn start --help
yarn start new --help
yarn start system
yarn start ui
yarn start ui table
...etc

Better way

This way is showing how to run the CLI in folder of your choice. Ideal for creating a new projects via CLI.

$> <BINPath>/run

Build the project yarn build
Copy to your clipboard path to bin folder inside the project (Example of path ~/Projects/.../tooling-framework/cli/bin)
Open a new terminal and navigate to some test folder (ex. ~/test-folder)
Run a command
Mac: ~/Projects/.../tooling-framework/cli/bin/run Win: C:\Projects\...\tooling-framework\cli\bin\run
You should see a help page for Kepler CLI, similar to this:

Command examples:

<BINPath>/run --help
<BINPath>/run new --help
<BINPath>/run system
<BINPath>/run new ts
<BINPath>/run ui table
...etc

Installation

Kepler CLI is installable as NMP Module: npm install -g @kepler-io/cli.

Upgrade of package is available via command: npm install --global @kepler-io/cli@latest

You can list all installed packages with their versions on your machine via command: npm list --global

Packing

shebang (executable) file is located in ./bin directory.

You can test packaging locally via npm pack and install generated tar file.

npm install -g kepler-io-cli-vx.x.x.tgz

Publishing

Publishing is done via NPM (not Yarn): npm run publish-remote.

https://www.npmjs.com/search?q=kepler-io

Commands

Local development

Status	Command	Description
✅	`kepler new`	Create a new project with Wizard.
✅	`kepler new tool`	Create a new custom tool
✅	`kepler new app`	Create a new sample web app

Status	Command	Description
✅	`kepler open [browser] [port]`	Open a specific browser with a specific debugging port open
✅	`kepler open wizard`	Open a browser with debugging port open via wizard

Framework

Status	Command	Description
✅	`kepler system`	Prints a system information

Kepler CLI UI

Status	Command	Description
✅	`kepler ui`	Browse Kepler CLI UI with wizard
✅	`kepler ui table`	Prints examples of Kepler CLI Table
✅	`kepler ui progress-bars`	Prints examples of Kepler CLI Progress bar
✅	`kepler ui tasks`	Prints examples of Kepler CLI Tasks