runtimekit-cli 0.1.0

Generic CLI for scaffolding and managing modular runtime applications.

RuntimeKit CLI

RuntimeKit CLI is a generic command-line tool for scaffolding and managing modular runtime applications.

It can generate modules, pages, stores, backend routes, descriptor wiring, dependency wiring, release commands, installer collection, and safe cleanup commands for a workspace that follows a modular runtime layout.

Install

From PyPI after publishing:

python -m pip install runtimekit-cli

From GitHub before publishing:

python -m pip install "runtimekit-cli @ git+https://github.com/Susheer/runtimekit-cli.git"

Configure

Run this once per machine or environment:

runtimekit config init --workspace /path/to/spec --name "My Runtime"

The configured name is only local CLI metadata. It does not need to be hardcoded into the package.

Show config:

runtimekit config show

Common Commands

runtimekit doctor
runtimekit add module APP.WorkOrders --backend --store
runtimekit add page APP.WorkOrders WorkOrderDetails
runtimekit add store APP.WorkOrders WorkOrdersStore
runtimekit add dependency APP.WorkOrders OTHER.SharedFeature
runtimekit add include OTHER.SharedFeature --app APP
runtimekit prepare
runtimekit inspect runtime
runtimekit run browser --open
runtimekit run electron
runtimekit release make --target mac-dmg
runtimekit clean --target build --target installer --dry-run
runtimekit remove module APP.WorkOrders --dry-run

Destructive commands require --yes unless --dry-run is used.

Release Artifacts

Release builds can collect generated installer files into a root-level installer folder:

runtimekit release make --target mac-dmg

The collected output defaults to:

installer/

Override it with:

runtimekit release make --target mac-dmg --installer-dir published-installers

Development

python -m unittest discover -s tests
PYTHONPYCACHEPREFIX=/tmp/runtimekit_pycache python -m py_compile runtimekit_cli/cli.py tests/test_cli.py
python -m build

Publish

The recommended publish flow is PyPI Trusted Publishing from GitHub Actions. Create a PyPI project for runtimekit-cli, configure a trusted publisher for this repository, then publish by creating a GitHub release.