CLI Overview

The Re-Shell CLI is invoked as re-shell. It exposes a set of top-level commands for project lifecycle plus command groups that bundle related functionality. At CLI 0.29.2 there are over 500 registered commands across the groups.

re-shell --help
re-shell --version   # 0.29.2

Top-level commands

Command	Purpose
`init <name>`	Initialize a new monorepo workspace (Frontend, Full-Stack, Microservices, Polyglot).
`create <name>`	Create a new Re-Shell project with a shell application.
`add <name>`	Add a microfrontend to an existing project.
`remove <name>`	Remove a microfrontend.
`list`	List all microfrontends in the current project.
`tui`	Launch the interactive terminal UI (Ink).
`ui`	Launch the local web dashboard.
`build [name]`	Build all or specific microfrontends.
`serve [name]`	Start the development server.
`doctor`	Run health checks on the monorepo.
`analyze`	Analyze bundles, dependencies, performance, security.
`completion`	Install shell completion scripts.
`ai <prompt...>`	Resolve a natural-language prompt to a command (offline).
`commands`	Introspect available commands as a machine-readable catalog.

Command groups

Group	Purpose
`workspace`	Workspace health, dependency graph, topology, sync, policy, drift, migration.
`templates`	Discover and inspect framework templates.
`generate`	Generate code, tests, docs, backends, and features.
`api`	OpenAPI/Swagger, versioning, validation, testing, docs, gateway, clients.
`service`	Polyglot services + cross-language service bridges.
`k8s`	Kubernetes manifests, Helm charts, GitOps.
`cloud`	AWS/Azure/GCP deployment and CDN management.
`observe`	Metrics, tracing, logging, APM, alerting.
`security`	Security, compliance, and governance generators.
`data`	Database migration, pooling, cache, ORM utilities.
`collab` / `learn`	Collaboration and learning generators.
`plugin`	Manage CLI plugins and extensions.
`tools` / `config` / `quality`	Dev tools, configuration, code quality.

Every group prints its own help:

re-shell workspace --help
re-shell templates --help
re-shell k8s --help

Command introspection

The commands group exposes the entire surface as a machine-readable catalog — the same data the dashboard’s Command Builder and the offline ai resolver read:

re-shell commands list --json > catalog.json

Pipe caveat. The CLI exits as soon as a command resolves, which can truncate very large JSON payloads (such as commands list) when stdout is an OS pipe. Redirect to a file (... --json > out.json) for the full payload.

The JSON contract

Commands marked with --json emit the typed { ok, data, warnings } envelope defined in @re-shell/contracts. Error envelopes set a non-zero exit code. See the JSON Contract page for the full specification and error-code vocabulary.